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he story of Raspberry Pi Zero is intertwined with The 
T MagPi magazine. Zero was first introduced to the world in 
The MagPi magazine issue #40. This fantastic single-board 
computer is the entry point for many of our readers. 
We're impossibly proud to introduce Raspberry Pi Zero 2 W. 


Lucy 
Thanks to a clever design technique, it packs a faster quad-core Hattersley 
CPU into the same tiny footprint. You can use Zero 2 in your Lucy is editor of 
. . The MagPi and it's 
current project (just swap out aZero foraZero 2and getan months like this 
instant speed boost), and Zero 2 is compatible with the vast array а M 
of kits and current home builds. о 


magpi.cc 


Our Zero 2 feature (page 34) brings you all the information on 
this exciting new computer. And every subscriber to The MagPi in 
print will be getting a free Zero 2 in the post. We take great care 
of our subscribers and routinely hand out free gifts, from the 
original Raspberry Pi Zero to Google AIY Voice Kits, Raspberry Pi 
OS installation CDs and cooling stands, and now, Zero 2. 

It is worth subscribing to The MagPi. All new subscribers 
will also get a Raspberry 
Pi Zero 2 W (see page 32). ТЫ 
On a personal note, a big | The 
thank-you to everybody who | 
subscribes to The MagPi. You 
keep this magazine alive. 
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Lucy Hattersley Editor 
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Raspberry Pı 


Build HAT announced 


Discover the new collaboration between LEGO® 
Education and Raspberry Pi. By Lucy Hattersley 


collaborating on a new product: the 
Raspberry Pi Build HAT. 

The Build HAT is designed to combine the 
power of Raspberry Pi with the LEGO Maker Plate 
included with the LEGO Education SPIKE™ Prime 
expansion set. 

Tom Hall, General Manager at LEGO Education, 
said: “Combining SPIKE Prime with Raspberry Pi 
will inspire students to explore more advanced 
creations and continue to nurture their interest 
in STEAM learning. This brings in even more 
high ceiling learning opportunities that tap 
into the maker space and encourage students to 
combine different products. The Raspberry Pi 
Build HAT will be available through Raspberry Pi’s 
authorised reseller network.” 


R aspberry Pi and LEGO® have been 


Brick building 
У Build a remote The Build HAT is compatible with the most 
a recent generation of LEGO Technic™ motors, 
and LEGO and sensors. An optional extra, the Maker Plate, 
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A. Raspberry Pi Build HAT 
provides four LEGO sockets 
and a 5.5 mm barrel plug 
to power and control LEGO 
motors and sensors 


is included in the latest LEGO Education SPIKE 
Prime portfolio (version 45681; £362 / $340; 
magpi.cc/spikeprime). With the Build HAT 
attached, Raspberry Pi can control up to four 
LEGO motors and/or sensors using Python code. 


2 Combining SPIKE Prime 
with Raspberry Pi will 
inspire students @ 


The Build HAT itself costs $25 and a compatible 
48W (8V DC, 6A) power supply is sold alongside 
for $15. With the power supply attached, the 
Build HAT powers both Raspberry Pi and LEGO 
motors and sensors. 

Build HAT is the second Raspberry Pi 
product to feature the RP2040 microcontroller 
designed by Raspberry Pi and first introduced with 
Raspberry Pi Pico. 

See magpi.cc/buildhat for more information. 
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У The face on this 
robot can be made 
happy or sad using 
Python code to 

| | control motors 
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A The kit comprises 
a Raspberry Pi 
400 Desktop Kit 
and monitor 


Leaving a legacy 


IT veteran Gerry Fillery leaves a donation to help the next generation of coders 


hile Raspberry Pi was initially 
W developed for young people, folks of 

all ages have picked up our favourite 
microcomputer for fun and practical projects. 
Gerry Fillery was one of those people. 

Having retired from his career in IT ten years 
ago, Gerry took an interest in Raspberry Pi, and 
had projects set up around his house. “Each time 
I would visit him he seemed to have acquired 
more bits and pieces, he was quite an enthusiast," 
recalls his friend. 

Gerry's interest in Raspberry Pi was so great that 
he decided to leave a donation to the Raspberry Pi 
Foundation in his will, and is the first person to 
have done so. His generosity will help support the 
computer science and maker education of millions 
of young people all over the world. 


Connecting people 

A part of this donation has gone towards 
distributing free Raspberry Pi Desktop kits to 
those who do not have a computer at home as 
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m His generosity will help 
support the computer 
science and maker 
education of millions of 
young people Л 


part of the Stay Connected to School initiative, 
allowing them to stay connected to learning 
whilst schooling is disrupted. 

“Gerry is our first ever legacy donor," said 
Teresa Hicks, Director of Strategic Partnerships 
at the Raspberry Pi Foundation. “We are 
incredibly grateful for his generous gift. His 
legacy lives on through helping us to bring maker 
education to young people all over the world". 


Vocal vocation 
Gerry grew up in Blackheath, London. As a 
youngster, he also had links to Fairlop and Seven 


Mádpi 


. а 


The donation was able to 
fund several kits for young 
people. Partners like the 
East London Business 
Alliance (ELBA) have 
supported kit distribution 


Ideal for family 
learning + clubs! 


Ideal GIFT and 


A The kit comprises в 
а Raspberry Pi j 
400 Desktop Kit \ 1, 
Е | starter project book! 


and monitor 
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and help bring computers and computing ө Clear and easy-to-read = 
education to young people around the ñ " | um s qe 5 
world, you can donate to the Raspberry Pi large format (10 X 8 ) Dem es E 
c 
z 
E 
T ё 
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Foundation at rpf.io/donate. 
@ Raspberry Pi based 
projects + mac/PC and 


Chromebook compatible 


Order: 20% OFF 


Kings, and was educated at Edinburgh University 
where he studied as a Statistician and Actuary. 

He worked as a techie throughout his career 

preferring a technological challenge. 

He would often talk of voice applications in 
tech, a field he was very familiar with: he worked 
on early bank telephone automation systems. 

He lived for the last 20 years of his days in 
Frimley Green, Surrey. Thank you, Gerry, for all 


books or ebooks! tarquingroup. com/pi 


you have done. 
Leaving a legacy magpi.cc T 
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SPY-DER 
Robot 


A multi-legged surveillance robot combines Al and 
Raspberry Pi, Rosie Hattersley learns some spidey-sense 


of spiders may find themselves a little 
uncomfortable at the design of the latest AI 
robot created by the Sparklers, a group of computer 
science engineers in India. Not only does the robot 
specialise in watching its object's every move, 
but it has multiple legs and the ability to move in 
unexpected ways. 
Team leader Arijit Das explains that SPY-DER 
is so- named because of its ability to walk like an 
arachnopod - much to the consternation of some 


T hose of us with an aversion to the company 


Arijit Das 


Indian computer 
Science engineer 


Arijit runs a group Observers. The robot's main purpose is for live video 
of т surveillance, streaming footage that can be viewed 
enthusiasts calle E ë 

Sparklers that remotely via a dedicated web browser. SPY-DER | 
focuses on making can be controlled in two ways, either through voice 
Al- and robotic- commands or from the web interface. Riffing on one 
hased projects of the favourite items of prey for real-life spiders, 
such as a Sudoku- M c 5 Я 

solving buddy. Arijit uses ‘bumblebee’ as the robot’s wake word, 


prompting its LED eyes to light up. 

“Whenever I call it by its name, it starts listening 
to me and then, based on my voice command, it 
will act,” he clarifies. These commands cover both 
speech recognition and ‘intent detection’. “I can give 
SPY-DER the same command in different ways, i.e. 
‘Wave your hands’ or ‘Say hello’. Both commands 
make it wave its legs,” says Arijit. The online 
control panel, meanwhile, lets the user control all of 
SPY-DER’s actions. If such movements don’t make 
you tense up, you can take a look at SPY-DER in 
action at magpi.cc/spyderyt. 


magpi.cc/spyder 


Servo motors are used to control 
the legs, which wave majestically, 
just like a friendly spider 


Evolutionary process 
The first version of SPY-DER was an Arduino Nano- 
based device, controllable via an Android smartphone 
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| 
Raspberry Pi Zero W enables the web 
control interface and manages the 


voice recognition and Al elements 


мб 
№ 


Quick FACTS 


» z SPY-DER can 
1 be built over the 
course of a week 


Arijit's version of 


Don't be alarmed, but on hearing the chassis is here: 


the wake word, the SPY-DER magpi.cc/ 
robot's LED eyes light up spyderprint 


He built his own 
after seeing how 
much commercial 
robots cost 


Reactions from 
friends and his 
pet rabbit have 
been extreme.. 


Extreme delight or 
extreme fright! 
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>» SPY-DER mimics its near 
namesake but operates 
on just four legs 


W SPY-DER's eyes light up 
ominously in response 
to the wake word 
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I spy... spy spiders 


To build your own spider robot, first follow Arijit's 
online instruction video: magpi.cc/spyderbuild. 
The second YouTube video explains how to 
incorporate Raspberry Pi in order to make use of Al 
features: magpi.cc/spyderai. 


or web browser, but lacking the voice recognition А AE aha: 
um : parts ror the spider 
aspect Arijit was keen to add. “Obviously I needed a robot's chassis 


small computer here," he comments. Several of his 
previous projects, including the Sudoku-solving 
robot we featured in The MagPi #98 (magpi.cc/98), 
were based around Raspberry Pi. Size constraints 
led Arijit to choose Raspberry Pi Zero W this time. 
Wireless connectivity and the ability to connect 

to a Raspberry Pi Camera Module were also 

critical features. 

The limited RAM provision of Raspberry Zero W 
presents a challenge for Arijit’s hope of eventually 
implementing a local speech and intent recognition 
system from scratch. The speech recognition 
system would need to be highly optimised, 
otherwise it will take a lot of time to recognise the 
speech, he acknowledges. For now, SPY-DER uses 
an amended version of Picovoice (picovoice.ai) 
speech recognition, but in time Arijit also aims to 
add image processing and AI-based features, such 
as object tracking and face recognition. 


Download and 3D-print the spider body 
parts (magpi.cc/spyderprint). Then attach 
the servo motors for the legs, and assemble the 

rest of the body. 


Attach battery and charging cables, Arduino 
and Arduino IO shield, and install the Arduino 
code before inserting Raspberry Pi Zero W, USB 

microphone, and Camera Module. 


Building it 

Rather than designing SPY-DER's body from 
scratch, and having recently got his first 3D 
printer, Arijit adapted an existing spider robot 
chassis (magpi.cc/spiderbot), changing its 
dimensions to accommodate Raspberry Pi Zero W, 
microphone, and the Camera Module. He tweaked 
the spider robot’s Arduino code, but wrote the 
Python code for Raspberry Pi to be able to control 
SPY-DER. The web controls use a Flask framework 
with a web page coded in HTML, CSS, and jQuery. 
“For the live video streaming, I used RPi-Cam- 
Web-Interface (magpi.cc/rpicamweb), due to 

the fact that the latency is very low here,” Arijit 
explains. Helpfully, he provides diagrams and code 
at magpi.cc/spyder. Ш 


Download the project code from Arijit's GitHub 
repository (magpi.cc/spyder) along with 
Picovoice, amending the code as indicated. For video 
streaming, you'll also need to install the RPi-Cam- 
Web-Interface. 
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Automatic 
Guitar Tuner 


A Pico-powered automatic tool to tune your guitar? 
Nicola King is inspired to start strumming 


Guyrandy 
Jean-Gilles 


Guyrandy is an 
engineer and maker 
from the US east 
coast. He got his 
bioengineering 
degree from 

the University of 
Pennsylvania, and 
currently works 
inthe medical 
device industry. 


magpi.cc/ 
tunergitlab 


an ultra-cool guitar if you don't have 

the means to make sure it stays in tune, 
especially if you're pursuing a Springsteen-esque 
form of brilliance on the fretboard. 

Guyrandy Jean-Gilles is a musical maker who 
took Raspberry Pi Pico and created something 
rather special. “The goal of the project was to make 
alow-cost, automatic guitar tuner," he tells us. 
*Pd been meaning to do a project with Pico and 
there are few development boards as cheap and 
well-documented.” 


| еї?$ face it, there’s no point in having 


Pico power 

Guyrandy developed his idea over a two-month 
period, and the result is a very useful device. The 
guitarist chooses whichever string they want to 
tune and then places the tuner on the appropriate 
tuning peg. A button on the automatic tuner is 
held down by the user which then activates the 
microphone, and the tuner begins to determine the 


m i'd been meaning to do a project with Pico 
and there are few development boards as 
cheap and well-documented 8 


А Guyrandy demonstrates his automatic 
guitar tuner, here using it to turn the 
peg for the top E string 
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pitch of the tone coming from the plucked string. 
It then twists/adjusts the peg as necessary to 
ensure accurate tuning for sweet sounds. 

Guyrandy tells us that Pico is the brains of the 
entire tuner: *It samples an electret microphone 
at 4096 samples per second, computes an FFT 
(fast Fourier transform), finds the strongest 
magnitude frequency in the audio, then turns a 
DC motor clockwise or counter-clockwise until 
the target frequency and the strongest frequency 
in the audio match." 


Change your tune 

As with all electronic makes, this was a learning 
experience with a few bridges to be crossed, and 
the trickiest part of the build was determining a 
guitar string’s pitch from audio. "There's a lot of 
academic research in the area that I wasn't aware 
of before starting the project," says Guyrandy. 
“This version found the strongest magnitude in a 
fast Fourier transform, and assumed that was the 
fundamental frequency." 

In terms of accuracy, he found a few blips that he 
had to even out. “The tuner’s frequency detection 
is repeatable but inaccurate. It will mistakenly 
think harmonics are the fundamental frequency 
for almost all cases. Ihad to hard-code harmonic 
frequencies into the firmware to make the tuner 
work appropriately,” he explains. 

That said, the tunings are reliably inaccurate so 
they can be used to correctly tune a guitar. “For 
example, the low E string is 82.4Hz in standard 
tuning, but the project repeatable thinks it's 250 Hz. 
Currently alternate tunings aren't possible, but with 
a firmware change, drop tunings can be achieved." 

Guyrandy has had plenty of suggestions from 
other makers in terms of potential improvements, 
including adding a vibration sensor so the tuner 
can be used in a noisy setting, and also “to make 
a tuner that fits over all the tuning heads of the 
guitar and tunes all the strings simultaneously. 


The LED of the selected string 
lights up; two RGB LEDs below 
indicate the current status – 
green for correctly tuned 


While this is cool, I’m not sure how I'd separate 
two different fundamental frequencies from one 
audio signal." 

He is currently working on a second 
version of the tuner and will be trying the YIN 
(magpi.cc/yin) algorithm to detect frequency, as 
well as incorporating some piezo-electric sensors 


to pick up vibrations, along with a stronger motor. 


If you'd like to have a go at making your own 
version of the tuner, Guyrandy has generously 
made his code open-source, and information on 
exactly what you need in order to build it can be 
found on his GitLab page (magpi.cc/tunergitlab). 


Why not dust off that old guitar and get making? Ml 


Hold the push-button on top 
of the device to start listening, 
then pluck the string you've 


selected with the rotary knob 


The tuning head fits over 
a guitar peg and turns 
it automatically until it 
reaches the correct pitch 


Mägpi 


Guyrandy was 
inspired by 

the Roadie 3 
guitar tuner: 
magpi.cc/roadie3 


To make your 
own, you'll need 

a Pico, Adafruit 
PowerBoost 1000.. 


„plus tactile 
buttons, mini metal 
gear motor, and 
some LEDs 


In 2017, Guyrandy 
snappily decorated 
his graduation cap 
and gown.. 


„With the official 
7-inch display and 
a Raspberry Pi 3: 
magpi.cc/gradcap 


Guyrandy designed 
a slick-looking 
case for the tuner 
in CAD software 
and 3D-printed the 
parts for it 
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Electronic nose 


Sniffing out your surroundings wi 


th this next step in sensor technology, 
Pi to detect cheese or petrol 


Rob Zwetsloot asks о Raspberry 
ight sensors, temperature sensors, humidity 

L sensors, noises sensors (i.e. microphones) 
are all fairly common, however gas sensors 
are not something you see everyday. Using them 
specifically to ‘smell’ your surroundings is even rarer. 
Luis Rodriguez Mendoza is the creator of one of these 
rare projects. 

After learning about the different and weird things 
dogs have been trained to identify by smell at the 
airport, Luis asked the question of whether he could do 
something similar with low-cost gas sensors. 

*The purpose of the project is to show that low-cost 
sensors can be reliable in detecting odours and that 
they can possibly be used in clinical settings." Luis tells 
us. “Testing was done using samples of beer and brewed 
coffee. A K-Nearest Neighbours (KNN) algorithm was 
used in MATLAB to create a classification model that 
was used to predict the aromas of beer and coffee, and 
was validated using a 10-fold cross validation (k-fold)... 


Luis Rodriguez 
Mendoza 


A Geomatics 
Engineering 
Master's student 
at the University 

of Calgary. he is 
passionate about 
health and science, 
and applications 

of wearable 
technology. 


A 98 percent classification accuracy was achieved in 
the testing process." 


Smell test 
With only four types of gas sensors, extensive 
testing and training of the model was required. 

* A training data set was created by taking 
measurements of air, beer, and coffee 
independently." Luis explains. “Each sample was 
taken, on average, for 15 minutes at one second 
intervals, producing over 900 sample readings per 
test and the data was exported into CSV files. For 
classification purposes, an additional column was 
manually added to label the sample (i.e., coffee, 
beer, air). The three datasets were imported and 
combined in MATLAB. This data was used to create 
a k-nearest neighbour model, k was selected to 
be 5, this was determined by trial and error. A 
10-fold cross-validation was used to validate the 


2 Principal Component Analysis 
8 Beer 
5 Air 
15 Coffee 
1 о 
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N 
: 
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> The principal 
component analysis 
gives a more -2 Lo 
accurate reading of -10 $ 0 5 


what data is being 
collected Component 1 
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Using the Explorer HAT 
makes connecting all 
the sensors very easy 


2 — The sensors 
detect methane, 
hydrogen, carbon 
monoxide, and 
alcohol molecules 


A variety of gas sensors 
detect different types 


of scents 
The news article 


that inspired it 
was about dogs in 
Finnish airports 


L— 13N)3H13 


Luis likes to 
develop wearables 
that analyze 
biomechanics... 


. like his 
accelerometer 
that determines 
body position 


The whole setup is while cycling 
powered completely 
by Raspberry Pi 


Methane is part of 
the coffee aroma, 
however alcohols 
can also be part 
of it 
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Sniffing electronically 


Gas Sensor Reading 
> A 


we 
о Aime toh 160103469 
© 


The sensors are calibrated when it turns on - 
this is done by having the Python script run on 
start up, and holding the sensors away from anything 
you'd like to whiff. Once the sensors are calibrated to 
neutral, a sensor reading will be displayed. 


A Professional electronic 


model, anda Principal Component Analysis (PCA) noses are used in medicine 4 Weightod values of sensors In Air, Beer and Coffee _ 

a as an exploratory technique to verify th and engineering sectors — naa] | 
was used as ро = е шем fy i and can cost thousands ra 
model and the results, similar to the work shown uf ойлан ҹи] 
A Credit: CC BY-SA 4.0: Жог 
in past research. | ыле асос К 

“А test dataset was gathered by taking 17 new = 
samples of two-minute readings at one second } | ds 
intervals to assess the classification model. Each $ ' чым 
+ + & м, A с 
sample was independent of each other (only air, B "a enna 
beer, or coffee was measured at a time), and they к 
were manually labelled accordingly, resulting in oF 
over 2500 measurements. This data was imported, 
9 50 оо 1500 2000 2500 3000 


combined, and randomly rearranged in MATLAB. 
Using the classification model created from the 
training dataset, the testing data was classified and 
the results from the classification model represent 
97.7% accuracy.” 


те) 


Placing the e-nose on the sample will begin 
a reading using the gas sensors, which will 
be automatically logged in a CSV file for you to look 
at later. 


m | quickly realized how easy, 
efficient, and capable 
Raspberry Pi boards are Ø 


A near 9896 accuracy is extremely impressive 
for the three test subjects, and it's all done on a 
Raspberry Pi 3. 

"Raspberry Pi was introduced to me in the fall 
of 2020 during one of my university courses," Luis 
said. *I quickly realized how easy, efficient, and 
capable Raspberry Pi boards are." 

It's a cool, working concept, so we hope to see 
more like it in the future. Ш 


= 
Preccted Can 


The CSV file can be processed using MATLAB, 
and there are a couple of post-process scripts 
that Luis have created to output at confusion matrix 

with classifications, along with PCA and the raw data. 
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Pıco Light Arcade 


This inexpensive build was created in a single evening and 


it's set to provide hours of fun, as David Crookes discovers 


Thomas Roth 


Thomas Roth is an IT 
security researcher 
who lives in Germany 
and creates videos 
about hardware 
hacking and 
reverse-engineering. 


magpi.cc/ 
picolight 


unless you've grabbed hold of a soft rubber 
mallet and exerted huge amounts of 
energy on a satisfying game of Whac-A- Mole. 
Known as Mogura Taiji in Japan, where the game 
originated, it relies on speedy reactions to hit as 
many small plastic moles as possible - and when 
Thomas Roth had a go, he decided he had to create 
a version for himself. 
“Tt was a small arcade and my friend and I had 
so much fun with а game like this, I just knew І 
wanted to have one for our parties," he says. In his 
case, the ‘moles’ he was bashing were a set of LED 
lights and Thomas reckoned it would be relatively 
easy to replicate. “1 spent zero time planning 
it," he continues. *I came back from the arcade, 


A“ to a seaside arcade is rarely complete 


A Asif to prove German has a word for 
everything. Thomas refers to this messy array 
of wires surrounding Raspberry Pi Pico as 
"kabelsalat" - or cable salad in English 
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ordered the arcade buttons and, once they arrived, 
I drilled 20 holes into a board I had lying around.” 
The holes were arranged so that each player 
would have one button immediately in front of 
them, followed by a row of three and then a further 
five - making for nine each. Two buttons were 
placed in the centre: one to start the game and 
the other to select a playing mode. *I screwed in 
the buttons and wired them up in a 3x7 matrix," 
Thomas says. “There was no soldering involved.” 


Keeping score 

Once done, Thomas began to program the 

game and he reckoned a Raspberry Pi Pico 
microcontroller would be more than capable of 
running it. “I really like the simplicity of Raspberry 
Pi Pico,” he says. “Firmware updates are drag- 
and-drop, it's super-easy to code for, it's really 
cheap, and it boots up immediately, too." 

At first, he flexed his C programming skills to 
code what he describes as *a high-speed Whac-A- 
Mole" with the goal being to hit any buttons that 
light up as fast as possible. “Whoever manages 
to press the most buttons in 45 seconds wins," 
he smiles, adding that he then wanted a way of 
displaying the score. 

“I didn't have a nice display lying around so I 
built a Web Serial-based website that also shows a 
scoreboard," he says. “This is completely optional, 
though, and the table will run happily without it.” 


Mind games 

Once the rules of Whac-A-Mole were established 
and coded, he then moved on to create a second 
mode: replicating a game of Simon. “The table 
shows a sequence and both players have to 
remember and repeat it. The sequence gets longer 


Each player has nine buttons to 
press. These two in the centre 
allow games to start and different 
game modes to be played 


The table looks great with its retro-style 
video game stickers, coloured circles 
surrounding the buttons, and a black 
tape finish around the edges 


2 There was no soldering 
involved Л 


and longer, and whoever first presses a wrong 
button loses.” 

He's not ready to stop there, though. “I would 
love to have more game modes and I'd also love to 
see someone hook up a seven-segment display to 
show the score,” he reveals. “I’m also designing a 
PCB to make the underside a bit cleaner - as it is, 
there are 20 buttons with four wires to each and it 
looks messy.” 

Even so, it also looks like a heap of fun. “It 
certainly is, and it should be a great project for 
anyone to do with kids,” Thomas adds. “In fact, 
two friends of mine have already decided to build 
their own with their children, but adults will have a 
fantastic time with it too.” El 
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There are 20 arcade buttons in total 

but Thomas says they're 3.3V each and 
darker than he'd like. "You might want to 
change the resistor," he suggests 


» The build and 
code took three to 
four hours 


» It cost roughly $45 
to create 


» There are two 
game modes 


» The scoreboard 
uses the Web 
Serial API 


» You can choose 


your own 
button layout 


Warning! 


This project requires use 


of a drill. Be careful when 
using electric tools 
magpi.cc/drillsafety 


% A laptop is being used 


to display the score, 
but it's only acting 
as a screen. Thomas 
would prefer to use 
a seven-segment 
display, but didn't 
have any to hand 
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A Raspberry Pi sends out all the 


Notes are fed to info to the various tablets 


the tablet screen 
so everyone can 


follow along 


Bob Steele 


A retired software 
developer currently 
living in Portland. He 
writes software for 
the community jams 
and plays bass guitar 
with them. 


communityjams.org 


>» Who needs books of 


music when it gets 
sent to your tablet? 


A projector was 
experimented 
with, but it was too 
bright in the park 


Bringing the jam sessions outside thanks to a Raspberry Pi broadcasting 
notes and lyrics. Rob Zwetsloot grabs a seat and listens 


hile reading The MagPi, you might think 
W that a reference to aJam would be for 

a Raspberry Jam. In this case you’d be 
wrong, it’s about a community of musicians that 
like to play together. 

Over the course of last year, the way they play 

together had to change. Mainly, they had to move 
outside and that caused some problems. 
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*Community Jams (communityjams.org) 
couldn't play music indoors using our 
web-based chords and lyrics application 
(magpi.cc/musicapp),” says Bob Steele, a retired 
programmer and current Community Jams member. 
“Outdoors, I put the app on a Raspberry Pi so we 
didn't need an internet connection. Raspberry Pi 
had a web server to deliver the application from 
Apache. Unfortunately, the projector was too weak 
in bright sunlight and was always subject to having 
its screen blow over in the wind. I figured out that if 
the app was delivered from [Apache] Tomcat, I could 
create a web socket protocol that would share the 
current song and position to many tablets. So now 
the musicians are outside, masked, separated by a 
good distance, and all able to share the same display 
on their personal tablets." 


Early adopter 

Although Bob has been programming and working 
with computers for several decades, he's mainly 
worked with software projects: “In the early 1980s 


A very simple setup, 
which allows for the 
group to play together 


I designed or help design a number of internal 
hardware projects for the video industry. 

“T heard about [Raspberry Pi] from the internet 
in the early days,” he says. “Руе ended up buying 


The musicians are happy 
that: 1) they get to play 
music in the park and 2) 
they know next to nothing 
about how it works 


at least one of every model. Don't know why, but 
they are good platforms for small projects. I first 
used UNIX in 1975 and my personal machine has 
been Linux for many decades ... so Raspberry Pi 
seems like home. In fact, most of them never get 
connected to a keyboard, mouse, or display. SSH or 
VNC is all I usually need." 


Can't beat it 
It's a simple project with a simple goal - to display 
music for musicians, and it works well in that 
regard according to Bob: *The musicians are happy 
that: 1) they get to play music in the park and 2) 
they know next to nothing about how it works." 
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Bob used to work 
in Silicon Valley 


Jam sessions can 
be traced back to 
1920s jazz 


Bassist Bob also 
has a bass guitar 
learning app on 
his site 


Community 

Jams spun off 
from Portland 
Casual Jams... 


„Which was created 
14 years ago and 
has 3700 members 


Der р : The web app that Bob 
The whole setup is just a Raspberry Pi 3 with created asseemon 


Bob's software, an access point to connect to a several screen sizes 
local wireless LAN, and a battery to run it. 
“I should have installed DNS instead of the fixed 


IP address," Bob ruminates. *The fixed IP address 
helps when Raspberry Pi is not in the park. It gets 
plugged in, attaches to the local WiFi, and updates 
itself using crontab jobs." 

While its humble use as a way to get some 
friends to play music together is great, we feel 
the technology is simple yet powerful enough to 
be expanded to larger groups. Check out Bob's 
website, bsteele.com, for more about Community 
Jams and his other projects. 
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Pico Robot 


[VA 


/ 


The smartphone's accelerometer not 
only picks up left and right movement, 
but allows MohammadReza to tilt 
forward and back to control the direction 


Rather than use a standard controller, this robot is steered using 
an Android phone's accelerometer. David Crookes takes a look 


obotics projects have long been popular 
among the Raspberry Pi community, but 
MohammadReza Sharifi’s outstanding 
contribution definitely has a touch of va va 
voom about it. Powered by a Raspberry Pi Pico, 
his four-wheel drive car is controlled using the 
accelerometer in an Android smartphone. “The idea 
suddenly came to my mind,” he tells us, “and it 


канна took me about three hours to build and program.” 
That itself is impressive, particularly given the 
MohammadReza work needed to get things moving. It all began two 


is a self-described 
geek, gamer, writer, 


cinema lover, 
YouTuber, and 


engineer. He lives in 
Khuzestan, Iran. 


magpi.cc 


months ago when MohammadReza was browsing 
Instagram. “I saw a promotional video about a toy 
in which a coloured ball was being controlled by 
mobile gestures," he says. *I thought to myself 
that controlling a robot using mobile gestures 
could also be an interesting project." 

From that point on, he quickly looked to gather 
the equipment needed. To start with, he bought 
an inexpensive plastic robot car chassis kit which 
came complete with four yellow wheels and four 
DC gear motors. He then added a L298 motor driver 
and an HCo5 Bluetooth module. 


Speeding ahead 

“Т decided to connect these to a Raspberry Pi Pico 
microcontroller,” he says. “Га seen that a small 
number of robotics projects had been implemented 


Raspberry Pi Pico Robot 


using Raspberry Pi Pico, and I wanted to experience 

the challenge of working with the microcontroller.” 
To ensure that the robot could make use of 

a smartphone's accelerometer, MohammadReza 

needed to develop a custom app. He did 

so using the MIT App Inventor platform 

(appinventor.mit.edu) - a blocks-based visual 

programming environment that makes it relatively 

easy to create software for mobiles. 


The biggest challenge was 
definitely building the 
mobile app 


*The main advantage of this platform is that 
you don't have to deal with coding challenges 
because it lets you focus more on the main 
concept of a project," MohammadReza explains. 
That said, it wasn't totally straightforward, as you 
can perhaps imagine. 


Twists and turns 

The idea was to create an app that would send data 
from the accelerometer to Raspberry Pi Pico in 
real-time via a Bluetooth connection. That way, 


Mägpi 


Raspberry Pi Pico processes 
the movement data in 
real-time, and sends the 
information to the motor driver 


When the smartphone is 
titled, the app on the device Tilting a 


sends the movement details smartphone steers 
to Pico via Bluetooth the robot 
A bespoke Android 
controller app 


was developed 
The chassis was bought 


online as an inexpensive 
kit. A breadboard was 
fixed to the top 


A Python app 
was created for 
Raspberry Pi Pico 


The project cost 
MohammadReza could tilt his smartphone left, for about £40 to make 
instance, and send information telling the robot to 
move left. 
This is what took up much of the development 
time. “The biggest challenge was definitely 
building the mobile app," he reveals. *It needed 
to identify the co-ordinate axes and identify the 
position of the accelerometer sensor in the mobile. 
It also needed to perform trial and error to find the 
amount of angular acceleration and the magnitude 
of acceleration." 

Eventually, however, it began to work near- 
flawlessly. He's now considering creating a version 
for iPhone, but although the MIT App Inventor web 
application is free, open-source, and allows apps to 
be made for iOS and Android, he's decided to use a 
different system for the Apple device. 

“I will create an iOS app for the robot using 
Kivy,” he says, referring to the free and open- 
source Python framework and relishing a fresh 
challenge. His priority first and foremost this time 
around, he adds, was just getting it to work with 
his Xiaomi Redmi Note 9 Pro Android smartphone 


and he's more than happy to see it going down well p 
with other makers online. *It makes me proud that 


people are interested in my project," he beams. - -——" "n 


See it in action 
at magpi.cc/ 
picorobotyt 
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Oasis-grow 


Growing fruit and vegetables can be so frustrating, but a 
Raspberry Pi-based smart agriculture project helps take the 
uncertainty out of cultivation. Rosie Hattersley reports 


Mike Lee and 
Aviel Stein 


Oasis-X co- 
founders Mike 
and Aviel met at 

a maker event 

in Pennsylvania 
where self- 
taught coder and 
entrepreneur Mike 
was showing off 
Several Raspberry 
Pi projects. 


oasis-x.io 


The temperature- 
controlled incubation 
tent has sensors to 
monitor humidity, 
airflow, and light levels 


organisms don't respond in linear ways," 

even when provided with supposedly 
‘ideal’ growing conditions, much to the 
frustration and disappointment of those keen 
to cultivate their own food, observes 25-year- 
old entrepreneur and technology fan Mike Lee. 
Such nonconformity “15 a mindset that many 
programmers and engineers find difficult to 


44 p lants, mushrooms, and other cultivated 
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accept," says Mike, explaining why he and his PhD 
student co-founder Aviel Stein set about improving 
the odds of a successful harvest. Their response, 
Oasis-grow, is a ‘smart agriculture engine’ 

that runs on Raspberry Pi and collects detailed 
information about whatever the user cares to grow 
in a bid for more predictable results. 

The system provides visual and sensor data, plus 
controls for heat, humidity, airflow, light, and 
watering cycles. The selling point is a system that 
“keeps your plants, mushrooms, and Petri dishes 
happy, and remotely monitors the grow space so 
you can identify and address problems before they 
get serious." 


Make room for mushrooms 
Mike and Aviel met at the 2019 Pennsylvania 
Maker Faire where, among other projects of his 
own devising, Mike presented his first Raspberry 
Pi project: a dashboard camera with buttons and 
a remote, back-window LED screen for signalling 
other cars. “It was very cool but perhaps a bit too 
dangerous for the road (the other cars did not 
react ... well),” he admits. Nonetheless, the pair 
decided to work together, and quickly formed 
Oasis-X (magpi.cc/oasisx) having identified a 
market for a smart agriculture monitoring tool. 
Aware that DIY plant monitoring and sensor kits 
were already available, Mike and Aviel needed to be 
sure they were offering something that fulfilled the 
scalability promise it would need to be of interest 
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Sensors attached їо Raspberry = Mike has been 
Pi 3 measure air humidity, light cultivating 
levels, soil moisture; a time- mushrooms for 
lapse camera is also used Ё ; two years 


Aviel has a long- 
term interest in 
permaculture 


The project 
attracted its first 
potential customers 
in August 2020 


From beta to 
manufacturing took 
Oasis-X a year 


Simplifying it 

and making 
improvements are 
of course ongoing 


Cultures could be cultivated in 
bottles or jars, or the whole box used 
to grow mushrooms and other crops 


Ses = el a шаша шщ 


Jtem 


Remote monitoring means the 
Oasis-grow setup can be located in 
a basement or cupboard, but plant 
progress is easily checked up on 
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Warning! 
Electrical Safety 


Please be careful when 
working with electrical 
projects around the 
home. Especially if they 
involve mains electricity. 


magpi.cc/ 
electricalsafety 


> Time-lapse images 
can be taken of the 
contents in their Petri 
dish habitat 
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to agriculture, and merit a commercial launch. 
Mike explains it was important for Oasis-X to take 
an “open-source first approach” to developing 
agriculture technology. “Technology vendor lock- 
inis such a big issue for farmers," he continues. 


2 Oasis-X is also keen to make the concept 
available for hobbyists and home 
horticulturists, providing source code and 
hardware architecture details via GitHub Л 


30 | magpicc | Oasis-grow 


*Our systems must collect and store lots of 
different information while communicating with 
the network and managing multiple independent 
processes, [so] a full-fledged operating system is 
close to required.” 


Ploughing ahead 

Oasis-grow’s makers took inspiration from 
older projects, and chose Raspberry Pi because 
of its multitasking capabilities and a file system 
that they found made organising and retrieving 
complex data a much simpler task. Most of the 
hardware they use for prototyping was bought 
from the usual online retailers, with Raspberry 
Pirunning Bash alongside Raspberry Pi OS and 
Python. Their web interface was created in Python 
and uses AWS (Amazon Web Services). 

*We've spent the last year nailing down the core 
functionality and are in the process of making it 
faster, more modular, and easier to use," Mike 
explains. The system went through more than 20 
iterations and was developed in close consultation 
with farmers and home horticulturists. This 
process helped Mike and Aviel realise that the 
vision, sensing, and environmental helper 
modules were valuable individually as well as 
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Grow your own 


Raspberry Pi 3B, а USB camera, and a power supply 
are the basis of this project. Full setup instructions 
can be found at magpi.cc/oasisgrowgit. 


Download the Oasis-grow code from the 
GitHub page (an installable operating 
image is in development, take a look at the GitHub 
instructions). Set up your incubation tent, or position 
the camera to monitor it. 


To start data collection, turn on the 
Raspberry Pi camera, start Python, and run 
main.py. If successful, the image loader will run on 
bootup next time. 


collectively. As a result, the pair are soon set to A. impressive results 


from their initial home 


offer an open-source version of the GUI integrating growing chambers 


machine learning, decision support, and smart 
notification prototypes. 

As an agri-business system, Oasis-grow had 
to prove its worth and has undergone successful 
long-term, large-scale field tests in farms in the 
eastern US over the past year. These ‘turn-key 
growing systems’ have recently been distributed 
to the company’s early backers, with a Kickstarter 
campaign fundraising towards its ‘smaller helper 
modules’ currently running. However, Oasis-X 
is also keen to make the concept available for 
hobbyists and home horticulturists, providing 
source code and hardware architecture details via 
GitHub (magpi.cc/oasisgrowgit). Ш 


For more detailed monitoring, add a relay 
board for AC control, GPIO buttons for a 
physical interface, environmental sensors, and LED 
status displays, as per Oasis-grow's full configuration. 
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MagPi | SUBSCRIPTION 


SUBSCRIBE TODAY 
FROM ONLY £5 


ОРТО Зо о 


» FREE Delivery 
Get it fast and for FREE 


» Exclusive Offers 

Great gifts, offers, and discounts 
№» Great Savings 

Save up to 35% compared to stores 


» Low monthly cost (from £5) 


№» Cancel at any time 
» Free delivery to your door 
» Available worldwide 


£55 (UK) £90 (USA) 
£80 (EU) £90 (Rest of World) 


Free Raspberry Pi Zero 2 W with 12 Month upfront 
subscription only (no Raspberry Pi Zero 2 W with 
Rolling Monthly Subscription) 


© Subscribe by phone: 01293 312193 
Q Subscribe online: magpi.cc/subscribe 


Email: magpi@subscriptionhelpline.co.uk 
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JOIN FOR 12 MONTHS AND GET A 


WITH YOUR FIRST 
12-MONTH SUBSCRIPTION 


A full Raspberry 
Pi desktop 
computer 


^ Learn to code and 
build your own 
projects 


Make your own 
retro games 
console, media 
player, magic ^i 
mirror and much. This is a limited 
’ р offer. Not included 
much more А А with renewals. Offer 


— subject to change or 
withdrawal at any time. 


SUBSCRIBE 


on app stores 


г лм, і 4, Available on the 
& App Store 
WIN! AIR QUALITY KITS UP FOR GRABS! m FIOI Y l £ 2.29 GETITON 

Б № Google Play 
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Introducing 
Raspberry Pi Zero 2 W 


FEATURE | Марі 
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aspberry Pi Zero 2 W is designed to be 

instantly swappable with Raspberry Pi 

Zero in a current project, with anidentical " - 
form factor and most components in the same ! — @ SYSTEM-IN-PACKAGE 
place. Dig a little deeper, and there are a host of 
tweaks and improvements across the board. 


Broadcom BCM2710A1 quad-core 
Arm Cortex-A53 (ARMv8-A) 64-bit 
@ 1GHz 


Broadcom VideoCore IV 
512MB DRAM 


802.11 b/g/n wireless LAN, Bluetooth 
4.2 (Bluetooth Low Energy, BLE) 


HAT-compatible 40-pin GPIO header, 
unpopulated 


microSD 


Micro SDCard slot, Mini HDMI, USB 
On-The-Go, micro USB power; 
composite video and reset pins 
(via solder test points), CSI camera 
connector 


1W (idle in Raspberry Pi OS GUI; 
Max power, 3.8W or 0.76A (32-bit 
mode); 5.5W or 1.1A (64-bit) mode 


$15 


66 x 30.5 x 5mm form-factor 
(compatible with Raspberry Pi Zero) 
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EI NEW POWER CIRCUIT 


One interesting new aspect of Raspberry Pi 
Zero 2 W is the System-in-Package approach 
@ WIRELESS LAN to the chipset design. 

A Broadcom BC2710A1 SoC is placed on 
the substrate and 512MB of DRAM is placed 
above, with an interposer placed between the 
two (to act as a 'spacer). This enables both 
chips to connect neatly to the substrate using 
gold wire. The whole thing is placed inside a 
mould. This is the black chip you see on the 
Raspberry Pi board. 


— Mould 


DRAM 


Interposer 


BCM2710A1 


The picture is a view of a3mm x 
2mm section of the System-in- 
Package. The black circles are 
solder balls. The thick grey lines 
are tracks on the substrate. The 
thin black lines are gold wires, and 
you can see them bonding to the 
silicon (which is transparent to the 
X-ray machine). Here, we can see 
the 0201 (50 um x 25um in size) 
capacitors inside the package. 


@ capacitors 
l INSIDE CPU 


Here is a top-down X-ray of the 
System-in-Package that reveals 
an Easter egg! Spot the Raspberry 
Pi logo shape in the ball map. This 
is possible because, while the 
connections on the outside are 
signals, the ones in the middle 
are ground/power and can be 
arranged into any pattern. 
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Eben Upton and Simon Martin 
on Raspberry Pi Zero 2 W 


e caught up with Simon Martin, 
W Principal Hardware Engineer at 

Raspberry Pi and Eben Upton, founder 
and CEO of Raspberry Pi. 

Simon: “Raspberry Pi Zero 2 W is all about how 
much power you can pack into such a tiny space. 
It’s about just how much can we get from such a 
small form factor. 

“Keeping that same form factor is important. 
An original Raspberry Pi Zero can be removed 
from a project and Raspberry Pi Zero 2 W can 
be plugged into its place. Any application that 
was there beforehand will get a boost from the 
processor performance. 

“Instead of using the single-core processor 
that’s in the Raspberry Pi Zero, we’ve got a quad- 
core Cortex-A53 processor, which is similar 
silicon to the original Raspberry Pi 3 when that 
was announced.” 

Eben: “There’s this whole question of ‘can 
we do it again?’ You can use Moore’s Law in two 
ways: you can take an amount of money and fill 
[Raspberry Pi] with more and more computing 
power, or you can take the current amount of 
computing power and deliver that at a lower and 
lower cost. And that’s what we did with Raspberry 
Рі 1 – we took a ten-year-old PC's processing 
power and delivered it at around $30. And then 
we launched Raspberry Pi 2 in 2015 and, lo and 
behold, we’ve done the thing that everyone else 
does: we’ve picked a price point and filled it out 
with six times as much computing power using 
Moore’s Law. 

“Raspberry Pi Zero is really the result of going 
‘Aha! We should do the same thing as we did 
before.’ We should take a Raspberry Pi 1’s worth 
of computing power and we should use Moore's 
Law to squeeze the price down. 
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*Every part on that board pays for itself. It's 
a single-sided board, and it only has reflowable 
components; it doesn’t have any through- hole 
components. So it can all be manufactured simply 
and robotically. 

“So, coming up to the sixth anniversary, and 
how to use everything we've learned from those 
five years, there's this whole question of 'can 
we do it again?’ And we're delivering most of 
Raspberry Pi's 3 power for not much more than 
half the price of a Raspberry Pi 3. 

“The reality is that earlier this year people 
found out that Raspberry Pi knows how to make 
their own silicon [see, Raspberry Pi RP2040 in 
Raspberry Pi Pico, magpi.cc/102 - Ed]. Raspberry 
Pi Zero 2 W is not our own silicon, but we package 
silicon in unusual ways 


Inside the package 
Simon: "It's also known as a 'stacked package’. It's 
the concept of putting more than one monolithic 
piece of silicon into a package to make a full system 
and package device. There's a BCM2710A1 SoC 
(system on a chip) in there and half a gigabyte of 
DRAM. These are both gold-wire stitched to the 
substrate. That is then encapsulated to make the 
package. And so, by doing this, we can get two chips 
into the space of one. 

* Because the chips are similar sizes you need 
to use a silicon interposer, or spacer, amongst the 
centre of the processor. Then, when you put the 
memory on top, it doesn't squash the gold wires 
that connect the processor to the substrate. The 
memory is very sensitive, so there's less desire to 
put anything on top of the memory, which is why 
the SoC goes on the bottom and the memory on top. 

*The A53 was the highest performance chip 
that we've ever used that used wire bonding in 


the package, and Raspberry Pi Zero 2 W displays 

а considerable uptick in performance. Single- 
threaded performance is approximately 40% 
faster than a normal Raspberry Pi Zero. Obviously, 
this is quite cool, but if you do a benchmark of the 
single-core on a Raspberry Pi Zero and compare it 
to the quad-core of Raspberry Pi Zero 2 W, you get 
more than five times the performance. Real time 
performance is around three times the speed. A 
Raspberry Pi Zero takes around 90 seconds to boot 
into the GUI, whereas Raspberry Pi Zero 2 W takes 
around 30 seconds. 

“It’s a small board, and if you are willing to help 
out by putting a heatsink on it, or if you put it in 
some sort of metal case where the heat can be 
drawn away from the chip, then it is possible to 
add voltage to the device so you can run it faster." 
A Raspberry Pi Zero 2 W with a cooling solution 
can generally sustain 1.2GHz performance." 

Eben: “We use thick copper inside the board. 
So, effectively, we dissipate the heat throughout 
the board. So if you look at Raspberry Pi Zero 2 W 
with a thermal camera, you'll see that it gets hot 
throughout the board. That's because we're using 
copper to move heat away from the CPU. 


Get to know what the numbers on the Raspberry Pi 
Zero 2 W's SiP mean: 


This is the SiP design number. The Ao 
refers to Raspberry Pi Zero, and the AU indicates 
the use of gold wiring. The first models used copper 
wires but it was changed to more expensive gold 
wiring to maximise long-term reliability). 


The week of manufacture (read right to left). 
Ours indicates the 41'st week in 2020. 


The date the batch was ordered (read right 
to left). In this case, 26 August 2020. 


*The can [Wireless Lan enclosure] is a forward- 
looking thing to the days where people want to 
design this into things. We've got to be upfront: 
there's not a huge amount of stock for the first 
year because ‘hey, there's a global semiconductor 
shortage.’ Looking ahead, this is a product that's 
going to be around for a long time, and we hope 
people will put it into product designs for OEMs.” 


There are many retro gaming projects for Raspberry 
Pi, and Raspberry Pi Zero lends itself extremely well 
to small, handheld consoles. Attach a screen, battery, 
consoles, and a 3D-printed case, and you're good to 
play handheld classics. 

There are some handy kits you can get to help build 
your handheld console, like this RetroFlag GPi Case. 


OF мати WITH STEREO 10080 
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Practice checking on your ticker with this simple heart 
rate monitor using the Enviro pHAT from Pimoroni, as 
well as a Pulse Sensor Amped. Put together by Jon 
Witts, it measures live heartbeats and displays the 
results on a Scroll pHAT HD. 


Raspberry Pi Zero 2 W has the CSI (camera 

serial interface) port found on most Raspberry Pi 
computers, enabling you to connect a Raspberry 

Pi Camera Module to the device. And the official 
case has a cover with a pin-hole space for the 
camera. Many makers have taken things further with 
3D-printed cases and LCD screens. Take a look at 
PolaPi-Zero for inspiration, and a guide to make your 
own Raspberry Pi Zero 2 W camera. 


The Mood Light is a Raspberry Pi Zero project kit 

from Pimoroni. It uses the GPIO pins on Raspberry 

Pi Zero to connect to a Unicorn pHAT with 32 RGB 
Dashcams can be attached to your car to record NeoPixel LEDs. You can set these to a single colour, 
video in case of an incident. ZeroView is amount or fade them through all the colours of the rainbow. 


with suction cups designed to house Raspberry 

Pi Zero. It includes a mount for your Raspberry Pi 
Camera Module. The cups enable it to be attached 
to a car windscreen, or any other type of window. 


Raspberry Pi Zero 2 W is great 
for powering an e-ink display, 
which draws less power than an 
LCD. The combination is perfect 
for presenting this always-on 
calendar that updates once an 
hour, or at the press of a button. 
Zonglin Li has infused the front- 
end with numerous widgets and 
an LED lights up when the screen 
is being refreshed. 


ongratulations on becoming a Raspberry 

Pi Zero 2 W owner. We're sure you'll enjoy 

discovering a whole new world of computing 
and the chance to handcraft games, control robots, 
build machines, and share your experiences with 
other Raspberry Pi fans. 

Getting started won't take long: just corral the 
extra bits and bobs you need on our checklist. To 
get set up, use Raspberry Pi Imager to set up a card 
and connect all the cables. This guide will lead you 
through each step. You'll find Raspberry Pi OS, 
including coding programs and office software, 
all available to use. After that, the world of digital 
making with Raspberry Pi awaits you. 


All the bits and bobs you need 
to set up a Raspberry Pi computer 


You'll need a microSD card with a 
capacity of 8GB or greater. Raspberry Pi 
Zero 2 W uses it to store the operating 
system and store programs and files. 

If you want to reuse an old card, you'll 
need a card reader: either USB or a 
microSD to full-sized SD (pictured). 


You'll need a Linux PC (such as another Raspberry 
Pi), Windows Linux PC, or Apple Mac computer, 

to run Raspberry Pi Imager to download and write 
Raspberry Pi OS onto a microSD card for Raspberry 
Pi Zero 2 W. 


Like any computer, you need the means to 

type commands, create code and documents, 
and otherwise control Raspberry Pi. You can 
use a Bluetooth keyboard, but the initial setup 
process is much easier with a wired keyboard. 
Raspberry Pi sells an official Keyboard and Hub. 
magpi.cc/keyboard 


Raspberry Pi Zero 2 W uses 

the same type of micro 

USB power connection as 

many old electronic devices. 

So you can recycle an old 

USB to micro USB cable 

and a smartphone power 

supply. Raspberry Pi also 

sells official power supplies 
(magpi.cc/products), which №. 
provide а reliable source \ 
of power. 


A standard PC monitor is ideal, as the screen will 
be large enough to read comfortably. It needs to 
have an HDMI connection, as that’s what’s fitted 
on your Raspberry Pi board. Raspberry Pi Zero 2W 
needs a mini HDMI to HDMI cable (or adaptor). 
magpi.cc/minihdmi 


AHDMI cable, such as 

one used by most modern 
televisions, is used to connect 
Zero 2 to a TV or display. You'll 
need a mini-HDMI to HDMI 
cable (or adaptor) 


A wired mouse or keyboard is connected to the micro 
USB socket. Most devices use a USB-A connection, 
and you may need a micro USB to USB-A adaptor 


Get it connected 

As you're setting up a Raspberry Pi Zero 
2 W, you'll need to use a USB-A to micro USB-B 
cable (or adaptor) to connect a keyboard to the 
smaller connection on a Raspberry Pi Zero W. One 
is included with the official keyboard, which also 
has additional USB-A ports to accept the mouse 
and other accessories. Or you can use a cable with 
your own keyboard. 


Mouse and keyboard 
You can either connect your mouse to a 
USB socket on your keyboard (if one is available), 


(magpi.cc/usbadaptor). 


then connect the keyboard to the micro USB socket 
(via the micro USB-A to USB-B adapter). Connect 
your mouse to one of these if possible. If not, 
you'll need a USB HUB so you can connect both the 
keyboard and mouse to the single USB-B socket. 


More connections 

Now connect your full-sized HDMI cable 
to the mini-HDMI to HDMI adapter, and plug the 
adapter into the mini-HDMI port in the middle of 


your Raspberry Pi Zero 2. Connect the other end of 
the HDMI cable to an HDMI monitor or television. 


Set up the software 

Now you’ve got allthe pieces together, 
it's time to install an operating system on your 
Raspberry Pi so you can start using it. Download 
Raspberry Pi Imager from magpi.cc/imager. This 
utility is available for Windows, macOS, and Linux 
computers, so choose the relevant version for 
your system. 


Write the 0$ to 

the microSD card 
Attach your microSD card to your PC or Mac 
computer, and launch Raspberry Pi Imager. Click 
the ‘Choose OS’ button to select which operating 
system you would like to install. The top option 
is Raspberry Pi OS (32-bit). With an OS selected, 
click the ‘Choose SD card’ button and select 
your microSD card (typically there will be just 
one option). 

Finally, click the ‘Write’ button and wait while 
the utility writes the selected OS to your card and 
then verifies it. When complete, you may remove 
the microSD card. 


Assemble your Raspberry Pi 

Now it’s time to physically set up your 
Raspberry Pi. Plug your PC monitor into the mains. 
Remove the microSD card from the SD card adaptor 
and slot it into the underside of your Raspberry Pi 
Zero 2 W. 


Power up 

Plug in your Raspberry Pi power supply 
and, after a few seconds, the screen should 
come on. Raspberry Pi OS will boot up. When 
Raspberry Pi OS first loads, you will need to set a 
few preferences. Click Next, when prompted, then 
select your time zone and preferred language, and 
create a login password. You're now ready to get 
online. Choose your WiFi network and type any 
required password. Once connected, click Next to 
allow Raspberry Pi OS to check for any OS updates. 
When it's done so, it may ask to reboot so the 
updates can be applied. You're all set to start 
enjoying computing with your very own Raspberry 
PiZero 2 W. 
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Sensory world: 
Build a fire 

and gas leak 
alarm system 


Enable Raspberry Pi to detect flames and gas leaks to raise an alarm 


range of senses. This enables us to be aware 
of whatever’s happening in our environment 
so that we can react to it. 

So, it makes sense (no pun intended) that your 
Raspberry Pi would also benefit from being able to 
sense things. Fortunately, this is made possible 
using a wide variety of electronic sensors. In this 
series, we'll explore some of the most commonly 
available sensors and their use cases. 

To start off, we'll build a simple fire and gas leak 
alarm system using a couple of sensors. When 
either hazard is detected, a visual and audible alert 
will be triggered. 


H umans experience the world through a 


Y Figure 1 The wiring diagram for the complete alarm system, 
including two sensors, LED, and buzzer 
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Connect flame sensor 

For this tutorial, we're using the 
flame sensor from the Waveshare Sensors 
Pack, available in the UK from The Pi Hut 
(magpi.cc/wavesensors), and also sold separately, 
but any similar sensor should work in a similar 
way. It uses PIR (passive infrared) to detect a 
change in temperature nearby. While the sensor 
has pins for both analogue and digital outputs, 
we only need the latter for our alarm, as a nearby 
flame will set the digital output to high. 

With the power turned off, connect the flame 
sensor to Raspberry Pi, as in Figure 1 (where it's 
at the bottom). We're powering it from Raspberry 
Pi's 3V3 pin, grounding it with a GND pin (both via 
the breadboard side rails), and the digital output 
(marked DOUT on the sensor) is going to GPIO 21. 


Flame test code 
With the flame sensor wired up, turn on 
Raspberry Pi. You should see the sensor's red 
power LED light up if it's connected correctly. 
To start with, we'll create a simple Python 
program, as in the flame test.py listing, to 
read the sensor and print out a message when 
triggered, to check that it's working correctly. 
From the desktop menu, go to Programming and 
open the Thonny IDE to start coding. 
To simplify the setup, we're using the GPIO 
Zero library rather than RPi.GPIO; at the top of 


E 


The MQ-5 gas sensor can detect 
butane, methane, propane, and 
other noxious gases 


— The passive infrared flame 


sensor detects any nearby 
fire within its scope 


our code, we import the Button method from it. 
We'll use this to sense when the digital output 
from the sensor is high, in effect the equivalent 
of a push-button being pressed. As it's connected 
to GPIO21, we assign the flame object to this with 
flame - Button(21). 

In an infinite while True: loop, we check 
whether the pin is high (if flame.value -- 1) 
and set the message (msg1 variable) that we'll be 
printing to the Thonny Shell area accordingly. 

In our print statement, we add the end = "Vr" 
parameter so that the message is always printed 
on the same line, which is a lot neater than using 
a new line each time. 


Flame on! 

Now it's time to test our sensor by putting 
a flame near to it to see if it triggers our alarm 
message. We used a disposable lighter for this, but 
you could just light a match. Always be careful with 
fire, though, and don't get the flame right next to 
the sensor as it's not fire- proof! 

Run your flame test.py Python code and then 
move the flame towards the sensor. Ours triggered 
at around 30cm distance, but the sensitivity can be 
altered by using a small crosshead screwdriver to 
adjust the screw on the sensor board - other flame 
sensors may have a potentiometer rotary knob on 
board for this purpose. 

When the flame is close enough to trigger the 
sensor, another red LED lights on ours to indicate 
this. The message printed in the Thonny Shell area 
should change from ‘No fire’ to ‘Fire!’. 


o 
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DOWNLOAD 
THE FULL CODE: 


magpi.cc/github 


flame test.py 


» Language: Python 


001. from gpiozero import Button 


002. 

003. flame - Button(21) 

004. msgl- "" 

005. 

006. while True: 

007. if flame.value -- 1: 
008. msg1 = "Fire! ^" 
009. else: 

010. $81 = "No fire" 
011. print(msgl, end = "\r") 


Add a gas sensor 

So, we have our flame sensor working 
correctly. Now it's time to add the gas sensor to 
our setup. We're using a Waveshare MQ-5 sensor 
for this, as featured in the Sensors Pack, but other 
similar gas sensors are available. The tin oxide 
layer inside the sensor has a high sensitivity to 
the presence of gases such as butane, methane, 
and propane. 

The sensor has pins for analogue and digital 
outputs, but we only need the digital output for 
our alarm. We connect that pin (DOUT) to GPIO14, 
and the VCC and GNC pins to 3V3 and GND (shared 
with the flame sensor via the breadboard side 
rails), as in Figure 1 (gas sensor at the top). 


TopTip & 


Analogue out 


For simplicity, 
we've used the 
digital outputs 

to trigger our 
alarm. To use the 
analogue outputs, 
you'll need to 
add an ADC chip 
(e.g. MCP3008) to 
convert them to 
digital readings. 


| You’ll Need 


> Flame sensor 
magpi.cc/ 
flamesensor 


> MQ-5 gas sensor 
magpi.cc/ 
gassensor 


> LED 
> Active piezo buzzer 


> Jumper wires 
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A Testing the flame 
sensor with a lighter. 
Be careful not to 
move it too near 
the sensor or other 
components! 


TopTip & 
Off board 


We've placed our 
sensors on the 
breadboard, but 
you could keep 
them separate 
from the other 
components and 
wire them up from 
there, with the 
digital outputs 
wired directly to 
the GPIO pins. 


flame gas test.py 


» Language: Python 


001. from gpiozero import Button 
002. 

003. flame - Button(21) 

004. gas = Button(14) 


005. msgl- "" 

006. msg2 = "" 

097. 

008. while True: 

009. if flame.value -- 1: 
010. msgl = "Fire!  " 
011. else: 

012. msg1 = "No fire " 
013. if gas.value -- 1: 
014. msg2 = "Gas leak!" 
015. else: 

016. msg2 = "No gas " 
017. print(msgl, msg2, end = "\r") 


Add gas to code 

While we could create a new program to 
test the gas sensor separately, we’ ll add it in to our 
previous code as it will then be simpler to rework it 
into our final alarm code later. 

In the flame_gas_test.py listing, we assign the 
gas object to GPIO18 with gas = Button(14). As 
before, we’re using the Button method to detect 
when the pin is triggered and thus set to high. 

We add a new msg2 variable, which we'll set to 
the message we want to print in the Shell area. 
This is done by adding some extra lines to our while 
True: loop. If the gas sensor pin is triggered (if 
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gas.value == 1), then the message will be set to 
‘Gas leak; if not, it'll be ‘No gas’. 

We add msg2 to our print statement, after msg1, 
again including the parameter end = "Ar" so the 
message is always printed on the same line. 


Turn on the gas 

Now it’s time to test our gas sensor to 
check it’s wired up and working correctly. As 
before, we’re using a disposable lighter for this, 
pressing the button to release a little gas without 
igniting it for the flame. You could use gas from a 
hob or cylinder, but you only need a tiny amount 
to trigger the sensor, so be sure to turn it off again 
after a couple of seconds. 

Run your flame. gas, test.py Python code 
and then release a little gas in the vicinity of 
the sensor. As with the flame sensor, the gas 
sensor's sensitivity can be altered by using a small 
crosshead screwdriver to adjust the potentiometer 
screw on the sensor board. 

When the presence of gas is detected and the 
sensor is trigger, another red LED lights on ours to 
indicate this. The second message printed in the 
Thonny Shell area should change from 'No gas' to 
‘Gas leak. 


Ш The gas sensor's sensitivity 
can be altered 8 


07 Let there be light 
If your sensors and code are working 

correctly, and the correct messages are shown 
when they're triggered, it's time to move on to 
the next part. Printed messages are all very well, 
but for a proper alarm you need a visual and/or 
audible alert. 

For the visual side, we'll add a standard red 
LED to our setup - ours is 5mm, but you can use 
any size. As always when using LEDs, a resistor 
is required to limit the current to make sure it 
doesn't receive too much and potentially burn out. 
With the LED placed in the breadboard, with legs 
in different unconnected rows, we connect a 330 О. 
resistor between the negative (shorter) leg and the 
ground rail of the breadboard. The positive (bent, 
onger) leg is connected to GPIO16 on Raspberry Pi 
as in the Figure 1 wiring diagram). 


А The Waveshare flame sensor has both analogue and digital 
outputs. Sensitivity can be adjusted with the screw 


Get a buzz 

For our audible alert, we're using a small 
active piezo buzzer to make a beeping noise. The 
buzzer will have a longer positive leg and a shorter 
negative one; their positions may also be marked 
on top of the buzzer itself. Connect the negative 
pin to the breadboard's ground rail and the 
positive pin to GPIO25 (as in Figure 1). 


Alarm code 

With everything wired up as per Figure 1, 
you're now ready to program your fire and gas 
alarm. In the final code, fire gas alarm.py, we 
add LED and Buzzer to the gpiozero imports at the 
top. We also import sleep from the time library, to 
use as a delay. 

We create two functions, one for each type of 
alarm: fire alarm and gas, alarm. Each uses a for 
loop which toggles the LED and buzzer on and 
off a set number of times, with a 0.5 sleep delay 
each time. 

Finally, in awhile True: loop, we check the pin 
values and trigger the relevant alarm when the 
pin receives a signal from the sensor. If neither 
is triggered, we show the default message and 
ensure the LED and buzzer are turned off. 


Sound the alarm 

Now to test the alarm system. As before, try 
positioning a flame near the fire sensor to check 
that the alarm is triggered, in which case the LED 
will blink and the buzzer will beep. Do the same 
for the gas sensor by releasing a small amount 
of gas; the alarm will sound again. Each time, an 
appropriate message will show in the Shell area. 


Taking it further 

We now have a simple working fire and gas alarm. 
To make the alert more obvious, you could add 

a relay switch to turn on a 12V tower light with 


A Тһе MQ-5 gas sensor can detect several noxious gases in the air 
and is highly sensitive 


buzzer (e.g. magpi.cc/towerlight). You could also 
send an email or push notification alert to your 
phone whenever the alarm is triggered. 

Next time we'll create an intruder alarm using 
noise and laser sensors. See you then. Ш 


fire gas alarm.py 


» Language: Python 


001. from gpiozero import Button, LED, Buzzer 
002. from time import sleep 

003. 

004. flame - Button(21) 

005. gas - Button(14) 

006. led - LED(16) 

007. buzzer - Buzzer(25) 


008. 

009. def fire alarm(): 

010. print("Fire! ", end = "\r") 
011. for i in range (10): 

012. led.toggle() 

013. buzzer.toggle() 

014. sleep(0.5) 

015. 

016. def gas alarm(): 

017. print("Gas leak!", end = "\r") 
018. for i in range (10): 

019. led.toggle() 

020. buzzer.toggle() 

021. sleep(0.5) 

022. 

023. while True: 

024. if flame.value -- 1: 

025. fire alarm() 

026. elif gas.value -- 1: 

027. gas alarm() 

028. else: 

029. print ("All OK ", end = "\r") 
03e. led.off() 

031. buzzer.off() 
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Warning! 
Fire and gas 


Never play with fire! Be 
careful when testing 
your alarm and don’ 

position the lighter flame 
too close to the sensors 
or other components. 
Only release a smal 
amount of gas and do 
itin a well-ventilated 
area. Do not rely on 
this DIY alarm for your 
safety. In the event 
of a real fire or gas 
leak, call the relevan 
emergency service. 


magpi.cc/firesafety 
magpi.cc/gassafety 
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Rob Zwetsloot 


Rob is amazing. He's 
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Editor of The MagPi, 
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magpi.cc 


| You'll Need 


> Keybow 2040 
magpi.cc/ 
keybow2040 


> OBS 
obsproject.com 


> VoiceMod 
voicemod.net 


> USB-C to 
USB-A cable 


Turn Keybow 
2040 into a 
stream deck 


Reprogram the RP2040 auxilliary keyboard into a 
powerful macro keyboard for streaming and more 


art, playing games, or just chatting with 

followers, it can be great to interact with 
folks while doing something else. 

It is also quite complex to stream. Starting with 

a complicated OBS setup to stream your game, 
and ending up with loads of extra tabs and audio 
mixers thrown in, there can be a lot to control 
and maintain while you're live, and even more 
to do if you want to use silly audio effects or 
zooms, etc. This is where a stream deck comes 
in, allowing for short cuts for various functions 
at the press of a button. A lot of dedicated stream 
deck products can be pretty expensive, though, 
so let's make something a lot cheaper and far 
more customisable. 


S treaming is fun. Whether you’re doing 


Construct Keybow 2040 

The Keybow requires some building 
before you use it - it's fairly simple though. 
You attach some standoffs, a middle layer, 
add the switches to the final plate, add the 
keycaps, and then sandwich it all together. 
There are some illustrated instructions here: 
magpi.cc/keybowbuild. You should be done 
before an episode of The Simpsons is over. 
For stream deck use, we also have a 3D- printed 
switch stand that it fits onto nicely, keeping the 
keys in eyesight (which is important, as we'll 
explain later). 
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Basic Keybow 2040 usage 
Plugging your newly built Keybow 2040 into 
your PC will activate the pre-installed code that 
turns it into a numpad using a basic HID (human 
interface device) script. The LEDs in the keys are 
turned off, but go green as they are pressed. 
As well as being usable while plugged in, 
you can also access the storage inside and find 
different examples in the examples folder. To use 
one, merely copy it to the top Keybow directory 
and change the file's name to code.py. 


ША lot of dedicated stream 
deck products can be 
pretty expensive Л 


Customise your code 

The code.py file is what tells the Keybow 
2040 how to operate. Looking through the 
examples, you'll be able to see how a lot of the 
individual parts work together. A full list of the 
functions can be found on the Keybow GitHub 
here: magpi.cc/keybowgit. 

As it runs on CircuitPython, based on 
MicroPython, a lot of Python knowledge and 
skills are transferable while writing any custom 
code. With one caveat though - using sleep is not 
recommended by Pimoroni, and it did not work 
with this build either. Still, there's a lot you can do. 


Stream Manager 
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Make quick changes that affect your 


stream without having to fumble 
with allthe open applications 


It's very quick to prototype and test your custom 
code as well - opening, editing, and then saving 
the code.py file will immediately reset Keybow 
2040 so that you can test out your handiwork. 


Keyboard shortcuts 

The basic keys used by the default code 
should be altered if you plan to use this as a 
stream deck. They function as a numpad, and 
while they will work as hotkeys, they may also be 
used normally by the software you're running. 
Luckily, the Arduino key library allows for 
multiple keys to be sent at once: 


keyboard.send(Keycode.LEFT CONTROL, Keycode. 
KEYPAD ZERO) 


In our code, we're still using numpad keys, but 
we've added the left CTRL key to the combo. You 
could easily use a different key, such as the scroll 
lock, or multiple keys. Just check to make sure 
the key combos you're planning on using aren't 
being used in other programs - we don't want any 
АГТ+Е4 incidents while streaming games. 


tert play Photeieqaili Aiso, ubathon is ii on 
бона Atm 
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Control your streaming 
with hotkeys activated 
from the stream deck 


LED colours 

We've opted for all the keys to be lit up 
while the stream deck is connected, and this can be 
done using a simple keybow.set all() command, 
where an RGB code is placed in the brackets. 
For our code we're using green (0, 255, 0), 
yellow (255, 255, 0), and red (255, 0, 0), and you 
can easily add or modify the colours as you see fit. 
АП the keys light up green when the Keybow is on 
(mostly to remind us that it is), and keys will turn 
yellow once activated. The red is used for the mute 
and voice change button when activated, just to 
differentiate them. 

For other colours, blue is a good one (0, 0, 255), 
as well as white (255, 255, 255). If you need another 
shade, simply enter the name of it followed by 
‘rgb’ into your search engine of choice. 


When pressed 

One of two most important parts of our 
code is the press handler function. As the code 
cycles, it waits for a key to be depressed before 
it starts doing anything. It gets told which key is 
being depressed, finds out which part of the key 


Turn Keybow 2040 into a stream deck 


Top Tip 


Manual 
combos 


The key combos 
you've set up 
can also still be 
done on your 
regular keyboard, 
in case you need 
a backup way to 
use a hotkey. 


magpi.cc 
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Ь Heres how the 


keys are laid out on 
Keybow 2040 related 
to the code 


TopTip ё 


OBS focus 


You may find 
some difficulties 
using hotkeys with 
OBS - make sure 
the window is in 
focus for them. 


Adding hotkeys to 
OBS is very easy, and 
it can control just 
about every aspect 


VOICE 
CHANGER 
—nr 


SOUND 
EFFECTS 
— 


AUDIO 
CONTROL 
—> 


OBS 
CONTROL 
———> 


combo it should use, and then sends that as a 
key press. 
We also have an if statement so that a specific 
key turns to yellow when depressed, as all this 
button does is stop any sound effects from 
playing - it can easily be applied to other keys by 
modifying this if statement. 


07 When released 
By having separate press and release 

functions, we save the code treating a button- 
press as multiple events. We can also define what 
happens when the button is released; in this case 
we change the colour of the key to indicate that 
it’s been used, as well as updating the keytoggle 
list, which we use to remember the state of the 
key (on or off, 10r 0) 

As we have many different buttons doing 
different things, we've racked up a long if 
statement - most are simply ‘change between two 


Adv 
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USB CABLE 


colours’; however, one of them treats a series of 
three keys differently: elif key.number »- 1 and 
key.number <= 3. Only one may be lit yellow at a 
time, and we'll be using this to select a type of 
voice modification. 

The and here also works as a Boolean operator, 
where AND means only if it satisfies both 
requirements, and OR means if it satisfies at least 
one requirement. 


Planning your layout 
For the code in this tutorial, we've set up 
the keys in categories, as shown in Figure 1. Keys 
0-30n the top line handle voice changing, the 
second row we use for sound effects, the third line 
for muting and stopping sound effects, and the 
last line for OBS hotkeys. 
Remember, the keys go from О to 15 only when 
the Keybow is orientated with the USB cable 
sticking out of the right side. 
Depending on your stream deck uses, you can 
make your own layout; however, be aware of the 
placement when programming. 


Special keys 

Our mute key and voice change key both 
turn red when activated. These are both important 
keys in the setup and if you're a bit forgetful, like 
us, you may not realise that the voice change key 
is still on until a helpful member in chat points 
out that you sound like a robot. 

They broadly function the same as any other key 

pressed; however, the differing colours do help 


Mägpi 


VOICEMOD 


DOWNLOAD 
THE FULL CODE: 


© magpi.cc/streamdeck 


@ 


Cave Cool Tune 
LCtri + Pad1 LCtri + Pad3 


Telephone 
LCtri + Pad2 


when you’re trying to quickly bump a key while 
drifting a Ferrari around LA. 


Toggle keys 
The keys 1, 2, 3 we are treating as toggle keys, 
as explained above. Here is how the code works: 


key.set_led(*rgb2) 
keytoggle[key.number] = 1 


This part sets the key to yellow, and changes the 
keytoggle list to on/1 for that key. 


if key.number != 1: 
keys[1].set_led(*rgb1) 
keytoggle[1] = @ 


This part checks to see if key 1 was not pressed, 
and the following two statements check for keys 2 
and 3. If those keys were not pressed, the colour is 
returned to green, and the keytoggle is set to off/o. 


Our mute key and voice 
change key both turn red 
when activated 


OBS hotkeys 

Just about every element in your OBS setup 
will be able to have a hotkey attached - whether 
it’s simply changing to a scene, showing and 
hiding an image, or to stop streaming. From OBS, 
click Settings and then select the Hotkeys tab. 

Click on the bar next to the function you’d like 

to hotkey, and then press the desired Keybow key. 


It will not only set the hotkey but also tell you 
what it is - a good way to check that your code 
worked properly. 


VoiceMod hotkeys 

VoiceMod is a great piece of software 
for doing fun voice changers, playing sound 
effects, and generally controlling the entire 
audio input for your stream. Selecting a 
modifier, you'll see a button to add a hotkey - 
click that and use the desired Keyboy 2040 key. 
The same is true for any sound effects or clips 
you upload. 

In the Settings, you can also add other 
hotkeys - for the code we’ve used, key 0 is for 
voice changer toggle, key 8 for mute/unmute, 
and key 9 for stopping any sounds. 


The free version of 
VoiceMod offers many 
features, and they all 
work with hotkeys 


Elevating and angling 
a stream deck can 
make it easier to 
press buttons.. and 
remember it's there 
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K.G. 
Orphanides 


K.G. holds that 
digital audio 
hardware peaked 
in the 1990s 

and is prepared 
to die on this 
preposterous hilL. 


@KGOrphanides 


| You’ll Need 


> USB to 5-pin MIDI 
cable 


> An external MIDI 
sound card 


> ScummVM 
magpi.cc/ 
scummvm 


> DOSBox-X 
magpi.cc/dosboxx 


Connect retro 
MIDI hardware 
to Raspberry P1 


External MIDI sound cards like the Roland MT-32 were the peak of computer 
music in the 1980s and 19905, They still work just as well today 


of 1980s and early 1990s computer music 

production and playback. We've used a 
Roland MT-32 and SC-55 in this tutorial, but you 
can use most external MPU, MT-32, GM, GS, or 
XG MIDI devices from the era. Although some 
current hardware MIDI sequencers are marketed 
to musicians, modern consumer audio interfaces 
usually lack integrated MIDI voices, and even early 
2000s implementations can suffer variable General 
MIDI sound bank quality. However, the Serda 
3XMA (magpi.cc/xam) is a well-regarded and, at 
€79 (£68), relatively inexpensive modern USB MIDI 
interface with sound banks designed for backwards 
compatibility with the SC-55. 


E xternal MIDI sound cards were the pinnacle 


Hook me up 

If you're using original 1980s or 1990s 
hardware, start by connecting your MIDI-to-USB 
cable. This has a standard USB Type-A plug on one 
end, and a pair of 5- pin DIN MIDI plugs on the other. 


Соло JACK Audié Connection Kit 


Audio MIDI | ALSA 


Readable Clients / Output Ports 
Il 14:Midi Through 
fl 20:058 MIDI Interface 


Writable Clients / Input Ports 
I3 14:Midi Through 
ЁЗ 20:058 MIDI interface 
M В 24:Vortex Wireless 2 
1 130:0tractor E 


A Above Here, we're using Jack's Connect interface to connect 
Qtractor to our MIDI interface, and our Vortex Wireless MIDI 
keytar to Qtractor. Think of the lines as patch cables 


54 | magpicc | Connectretro MIDI hardware 


Connect the MIDI OUT plug on the lead to the 
MIDI IN port on your audio interface. The MIDI IN 
plug on the cable goes into the MIDI OUT port on 
the sound card. Power up your external audio device 
and make sure you've connected headphones or 
speakers - audio connections vary. Our MT-32 rev о 
has only a pair of 1.4-inch TRS outputs, so make sure 
you have appropriate cables and adapters. On some 
devices, you should keep the MIDI device volume 
low to avoid crackling. Similarly, if you accidentally 
attach the MT-32's right output to your speaker's 
left channel and vice versa, your sound will be 
overwhelmed by static upon playing anything. 


Power me on 

Connect the USB-to-MIDI cable to a USB 
port on Raspberry Pi and power on. Raspberry Pi OS 
should detect it as an ALSA device. We'll check that 
it's there and then run a couple of tests to make 
sure it's plugged in, discover its port number, and 
play a MIDI file. Open a Terminal and enter: 


amidi -1 

sudo apt install pmidi 

wget wiki.ultimacodex.com/images/8/80/ 
Stones.mid 

pmidi -1 

pmidi -p 20:0 Stones.mid 


The port number after -p should be whatever 
pmidi -1 reports your device as. If pmidi doesn't 
list any devices, reboot Raspberry Pi. We're going 
to need MIDI sequencer software next, so let's 
grab Otractor and Jack right away. At the Terminal, 
enter: sudo apt install qjackctl qtractor. 


A Above Qtractor is a simple but effective Digital Audio Workstation 
(DAW) capable of handling MIDI files and composition 


Jack in 

To minimise latency, we're going to be using 
the Jack Audio Connection Kit, which should have 
been fully installed as a dependency of qjackctl. At 
the Terminal, type: 


qjackctl 


Now click Setup and, at the right of the screen, 
set MIDI Driver to seq from the pull-down. Leave 
the Advanced tab at default settings - if you’ve 
previously edited your Jack profile, you may need 
to reset the Output and Input Device fields to 
‘(default)’. Do not select your USB MIDI interface 
here, as Jack is looking for PCM audio support and 
will crash without it. 

From Raspberry Pi’s applications menu, go to 
Sound and start Qtractor. 


Import to DAW 

Time to try our Digital Audio Workstation. 
In Jack’s main window, select Connect and click 
the ALSA tab. Select Qtractor from the left column 
(Output ports) and USB MIDI Interface from the 
right (Input ports), then click Connect. A line 
should appear between them. 

In Qtractor, in a new project, go to the 

Track menu > Import tracks > MIDI. Select the 
Stones.mid file we were using earlier. This should 
open several tracks in Qtractor. Click the <| button 
to make sure the play head is at the beginning, 
then hit play. You should be able to hear and see 
our MIDI file. 


How about MIDI input? 

You can manually use Qtractor’s piano roll 
to create and edit music. But if you have a MIDI 
instrument with either a USB connection or another 
5-pin DIN and USB adapter, you can use that as 
a control surface to record or play music directly 
through your retro MIDI device. Plug in your 
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E o 
Uniquely, the Roland MT-32's 

display can be programmed to 

display a message, which some 

games take advantage of, like 

Sierra's Quest for Glory II 


отмо uM 
Sow мем Hake 


This £10 5-pin DIN MIDI to USB adapter 
works perfectly, but name-brand models 
like the £35 Roland UM-ONE-Mk2 are worth 
getting if you need guaranteed support for 
on-screen messages 


instrument, create a new Qtractor file, and go back 
to the ALSA tab in Jack’s Connect window - restart 
Jack if your MIDI instrument doesn’t show up. 
Connect your MIDI instrument on the left to 
Qtractor on the right, and Qtractor on the left is 
connected to your USB MIDI Interface on the right. 


Your own composition 

Go back to Qtractor, right-click in the 
left-hand pane, and select Add Track. Select Type: 
MIDI, Channel: 2, and Program: 17 for an MT-32 
harpsichord - or Program: 7 for GM hardware. 
Click OK and play. If that works, make sure you're 
at the start of the track, press record, play, and you 
can now record real-time MIDI input. Give each 
track its own channel - the MT-32 supports up to 
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Above The MT-32 defaults to receiving MIDI on channels 2-9; 
press the MASTER VOLUME and 5 buttons at the same time, then 
tap 1 to switch it to a more conventional channel 1-8 configuration 


eight simultaneous channels, plus percussion. The 
SC-55 and other General MIDI cards support up 

to 16. You'll notice that Qtractor doesn't display a 
patch map with instrument names. You can find 
an MT-32 list at magpi.cc/mt32 and a list of the 
GM GS instruments used by the later devices on 
Wikipedia (magpi.cc/midievents). 


Add real MIDI to ScummVM 
ScummVM allows you to play a wide 
range of retro and even modern games, from the 
classic LucasArts titles it was first designed for, 
to adventures by Sierra, RPGs by SSI, and modern 
AGS adventures. 

Go to magpi.cc/scummvmdownloads and 
download the ‘Raspberry Pi 3/4/400 with Raspberry 
Pi OS 32 bits (armhf)’ AppImage. Then download 
Beneath a Steel Sky - Freeware Floppy Version 
from magpi.cc/scummvmgames and extract it 
somewhere convenient. 

In your file manager, right-click on the 
ScummVM Applmage, select Properties, click the 
Permissions tab, and set the Execute pull-down 
to Anyone. Click OK, then double-click the file to 
launch it. 


MIDI configuration for ScummVM 

ScummVM uses ALSA to output to your MIDI 
device. Although they can work together, stop Jack 
to avoid potential conflicts during configuration. In 
ScummVM, click Options. In the Audio tab, select 
your USB MIDI Interface as your preferred output 
device. In the MIDI tab, select it as your GM device. 
Finally, in the MT-32 menu, select your MIDI 
interface as the device and, depending on what 
hardware you have, tick either True Roland MT-32 
or, if you're using an SC-55 or similar GM/GS 
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sounpCanvas ^ 


Above More readily available than the MT-32, the Roland 
SC-55 and its successors use a particularly lovely-sounding 
General MIDI sound bank 


synth, Roland GS device. Click OK to return to the 
main screen. 

Select Add Game, navigate into the directory 
where you extracted Beneath a Steel Sky, and click 
Choose. Select the game's entry and click Start. 
The theme music should play through your MT-32, 
while SoundBlaster-compatible sound effects will 
come through Raspberry Pi's PCM output. 


Do it in DOSBox-X 

ScummVM can't play everything from that 
era, so we'll configure DOSBox-X to use our MIDI 
device, too. Open a Terminal and type: 


sudo apt install automake libncurses-dev nasm 
libsdl-net1.2-dev libpcap-dev libfluidsynth- 
dev ffmpeg libavdevice58 libavformat-* 
libswscale-* libavcodec-* 

git clone https://github.com/joncampbell123/ 
dosbox-x.git 

cd dosbox-x 

./build 

sudo make install 

dosbox-x 


73 -- 


Top Tip 


SC-55 in 
software 


If you want GM 
sounds without 
hardware 
tinkering 
download 
FluidSynth and 
direct your MIDI 
output through 
that via Jack. 
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At DOSBox-X’s Z: prompt, type exit. This will 
create the DOSBox-X config directory, Now we 
can export a config file for easier customisation. 
Restart DOSBox-X and, at the Z: prompt, type: 


CONFIG.COM -all -wcd 
exit 


Configure your MIDI settings. 

Restart DOSBox-X again. Click on the Main 
menu at the top left of DOSBox-X's menu bar and 
select Configuration Tool. Next to mididevice, type 
alsa. For midiconfig, type the device identifier 
pmidi gave us earlier - 20:0 in our case. If you're 
using a rev o Roland MT-32, you may need to add 
20:0 delaysysex to prevent buffer overflow issues. 
Save this to the config file we set up earlier and 
we're ready to try out a game. 


Obtain and extract 

Martian Dreams 
Go to magpi.cc/ultima2 and grab the free version 
of Martian Dreams - you'll need to create a GOG 
account if you don't already have one. The supplied 
file requires innoextract to use on Raspberry Pi, so 
open a Terminal and type: 


sudo apt install build-essential cmake 
libboost-all-dev liblzma-dev 

wget https://constexpr.org/innoextract/ 
files/innoextract-1.9.tar.gz 

tar xzf innoextract-1.9.tar.gz 

cd innoextract-1.9 

mkdir -p build && cd build 
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cmake .. 
make 
sudo make install 


Now cd to the directory containing the Martian 
Dreams installer and type: 


innoextract 'setup ultima worlds of 
adventure 2 - martian dreams 1.0 cs (28044). 


exe 


Copy the MARTIAN folder to a new /dos/games 
directory in your home. Go to that directory and type: 


dosbox-x INSTALL.EXE 


Press ENTER to progress through the options 
until you get to audio settings. Select Roland 
MT-32 or LAPC-1, then select Yes to save and exit. 
Exit DOSBox and, back at the command line, type: 


dosbox-x MARTIAN.EXE 


Tell me more 

Although a number of external MIDI 
sound cards had LCD screens, most just display 
instrument, volume, and similar data. The 
exception is the MT-32, which could display any 
text sent as a SysEx (MIDI system exclusive) 
message to its tiny screen. A number of games, 
including titles by Sierra and LucasArts, used this 
to display references to the on-screen action. 
For more MT-32 utilities and documentation, check 
out magpi.cc/mt32resource. Roland also continues 
to distribute software and documentation for its 
older audio hardware at magpi.cc/rolandtools. Л 


A See midi.org/ 
specifications 
for more specs 
and standards 


TopTip è 


Make your 
own MT-32 


If you can't get 
an external MIDI 
device, turna 
spare Raspberry 
Pi into one with 
the MT32-pi 
operating system: 
magpi.cc/ 
mt32pigit. 
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PJ Evans 


PJ is a writer, 
software developer 
and tinkerer. His 
server has just told 
him it's time for 
lunch. This might be 
getting out of hand. 


twitter.com/ 
mrpjevans 


Home Assistant can 
control hundreds 

of loT devices 

with customisable 
dashboards like this 


{KITCHEN 


Ultimate home 
server: enhance 


. your network 


Make your ultimate server a network genie with these apps 


taken a Raspberry Pi 4 and turned it into a 

file sharing, media streaming powerhouse. 
Next we’re taking on your network. There are 
so many ways to enhance your home (or office) 
network that we can’t hope to fit them into a few 
pages. However, these steps will point you in the 
right direction and hopefully inspire you to make 
your home network smarter, faster, and more 
convenient to use. Follow along and we'll automate 
your home, allow you to access your data securely 
from anywhere in the world, and automatically 
protect you from nefarious websites. 


| п the previous parts of this tutorial, we’ve 


Settle on an address 

A key aspect for any server is that you 
should know where it is. It seems obvious, but 
a typical home network will assign IP addresses 
dynamically (a system known as DHCP) and 
there's a fair chance they will change from time 
to time. We normally get around this by using 
zero-config domain names like ‘.local’, but we're 
going to need a set IP address for our server going 
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forward. The easiest way to do this is to ask your 
router to reserve an IP address for your ultimate 
server. We recommend you look at doing this 
before proceeding. Sorry for the vagueness, but 
every router does this differently. 


Home control the easy way 

Want to automate your home? Fancy being 
able to control lights or check a home webcam 
from anywhere in the world? How about if that 
software cost you absolutely nothing? Home 
Assistant is an incredible package that integrates 
a wide range of inexpensive smart devices such as 
Philips Hue, Ikea Trádfri, and many more. Best of 
all, its open enough that you can create your own 
activities and integrate your own projects relatively 
easily. Installation on an existing server requires 
a few steps, but a great guide has been written by 
the HA team - magpi.cc/hacore - that we have 
summarised here: magpi.cc/hasummary. 


Getting started with 

Home Assistant 
The first time you run Home Assistant, it'll take 
a few minutes or so to get its act together as it 
installs everything it needs. HA will also scan 
your network for any existing devices you have. 
Once running, you can access the dashboard at 
http://ultimate.10cal:8123 (change the name if 
you didn't call your server ‘ultimate’). You may 
be surprised to see what is already detected and 
available. If not, there are hundreds of plug-ins 
to extend HA's capabilities. Home Assistant is a 
massive topic, so you may want to have a read of 
our tutorial in The MagPi #99 (magpi.cc/99). 


MägPi 


N saw 
The Home Assistant app 
allows you to monitor and 
control all kinds of loT devices 


ару Our ultimate server now hosts a whole # N} 
Буа suite of network features in a tiny case 


Add an MQTT broker 

We will absolutely forgive you if this title 
sounds like gibberish. MQTT is a very simple 
protocol for sending messages from device 
to device. It is loved by the home automation 
community, so it's no surprise it's well supported 
by Home Assistant. The principle is simple: any 
device can publish its data (e.g. a temperature 
reading) to an MQTT ‘topic’ (a label to describe 
the data stream). Then, any other device can 
‘subscribe’ to the MQTT topic and receive updates 
in real-time. It makes brewing your own sensors 
or switches so much easier as you don't have to 
know about the target. 


A key aspect for any server 
is that you should know 
where it is 


A nice kind of mosquito 

One of the most popular MQTT brokers (a 
server that receives and broadcasts MQTT events) 
is Mosquitto. Installation is very straightforward: 


sudo apt install mosquitto mosquitto-clients 


You'll Need 
This will install Mosquitto and make sure it's 
К : p $23 Raspberry Pi 
running as a service at all times. To test it's à 
. : М Ultimate Server as 
working, open two Terminal windows and run built in The MagPi 


these commands, one in each: #108, #109, & #110 


mosquitto_sub -t "test" 
mosquitto_pub -m "message from mosquitto_pub 
client" -t "test" 


If all is working, you will see a window ‘talking’ 

to the other. Now anything that generates МОТТ 
messages can connect with you and your Home 
Assistant server. Just add the MQTT integration in 
HA and you can create graphs, alerts, and more. 


Adding remote access 

Previously, we've configured our server to 
stream audio and video and now we can switch 
lights, check the living room, feed the cat, and 
more. So, if you're not home, how do you do 
this? Remote access to your home network is 
not something to take lightly, as if you can get 
access, what stops someone else? The answer is 
PiVPN, a script that installs a VPN (virtual private 
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f virtual Private Network 


А Avirtual private 


network such as 
Wireguard creates a 
secure encrypted link 
to your home devices 
from anywhere 


Remote Computer 


Home or 


Office 


Router 


network) that you can connect to securely from 
anywhere in the world. Previously PiVPN only 
supported OpenVPN, which can be difficult to 
work with, but now the much simpler Wireguard 
protocol is supported. 


TopTip è 


Building 
your Home 
Assistant 
setup 


The Home 
Assistant 
community 
maintains a list of 
compatible smart 
devices. These 
either work 'out 
of the box or with 
a free plug-in: 
magpi.cc/ 
haplugin 


07 Installing Wireguard 
For lots of information on PiVPN and 
Wireguard, head over to The PiVPN Project at 
pivpn.io. To get started with installation, run the 
following command from a Terminal: 


curl -L https://install.pivpn.io | bash 


The installer will take you through a series of 
questions. An important point is to ensure you 
have a static IP address as your router willneed 
to know where to find your Wireguard server. 
When asked what type of server to install, 
answer ‘Wireguard’. Continue through the 
installer, accepting the default answers. If you 
don’t have a static IP address for your router, you 
may need to consider a dynamic DNS service such 
as DynDNS (account.dyn.com) so you can easily 
reach your Wireguard service. 


Using Wireguard 

Before you can use Wireguard to get secure 
remote access to your network, you need to allow 
the internet to ‘see’ it. This is done by creating 
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a port mapping. Your router needs to forward all 
traffic to port 51820 (default) over UDP to your 
server. How to do this varies from router to router, 
so search for your particular router’s instructions. 

To create users that can access the network, 
run this command: 


pivpn add 


Give a username when prompted and a config file 
will be created. Copy that config file to the device 
you want to use to access the network and import 
it using the free Wireguard client software. Now 
you can access your home network from a laptop 
or smartphone from anywhere in the world. 


Add a web server 

The fun thing about web servers is they 
are actually very simple things. You can place 
a text file in the home directory and the server 
will happily serve it anywhere in the world. If 
you would like to be able to access files through 
a web browser, you can combine Wireguard anda 
web server to make access both easy and secure. 
As an example, we’re going to configure access 
to the media library we have previously created. 
First, install a web server: 


sudo apt install apache2 


After that single line, you would be able to access 
a simple welcome page at http://ultimate.local. 


Adding directories to 

your web server 
What a web server can provide you with is only 
limited by imagination. Let’s get simple access 
to our music and videos, which are stored in 
/mnt/huge/Media. Apache has a complex 
configuration system, but we're going to play a 
little UNIX trick to make things easier: a symbolic 
link. This allows us to map one part of the file 
system to another, creating a kind of short cut. 


sudo In -s /mnt/huge/Media /var/www/html/ 
media 


Now you should be able to go to http://ultimate. 
local/media/ and browse your files. It isn't 
pretty, but it's a start! Now you can connect to 
your network securely and access files easily. 


m Pi-hole can protect your 
entire network, even 
your smartphone Л 


Avoid the dodgy advertising 

One of the most popular Raspberry 
Pi applications is Pi-hole (pi-hole.net), a 
clever system designed to ‘sink’ internet 
advertisements, leaving your browser clear of 
noise. While we strongly recommend supporting 
your favourite sites by allowing adverts, many 
sites contain ads that are not only scams, 
but can lead to tricking you into downloading 
malware that can compromise your data. 
Pi-hole can protect your entire network, even 
your smartphone. To install it, simply run this 
command from a Terminal: 


curl -sSL https://install.pi-hole.net | bash 
The installer will ask several questions, but is 


well-designed and you’re probably going to be 
OK to answer every one with the default answer. 


Starting off with Pi-hole 

Pi-hole works by looking at DNS requests. 
These are requests to servers that map domain 
names such as raspberrypi.com to actual servers. 
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It has a maintained blacklist of DNS servers 

that are for advertising and intercepts any such 
requests. To do this, Pi-hole must be your DNS 
server. Here things get complicated. For best 
results, your new Pi-hole server should also 

be your network DHCP server (the server that 
allocates IP addresses to your local devices). This 
requires some additional setup and we recommend 
you have a read of The MagPi #104 (magpi.cc/104). 


Careful with those ports 

A final warning. In this tutorial we’ve 
talked about opening ports to the internet using 
your router’s port forwarding features. You may 
be tempted to just directly open ports to the 
various services we’ve installed so you can get 
access wherever you are. One tip: don’t. The 
reason that services such as Wireguard exist is 
to ensure that bad actors can’t find any easy way 
to access your stuff. Wireguard uses state-of- 
the-art encryption. So long as your config file 
is not compromised, you’re more than likely 
completely safe. If you open your web server 
to the planet, we guarantee you will have bots 
sniffing around trying to find access within 
minutes. VPN isn’t easy, but it’s worth the time. 


Next time 

Well, we’ve built a pretty impressive 
server. File sharing, media streaming, 
remote access, network protection, and home 
automation. Next month we will look at how 
to protect all this hard work, and your precious 
data, from unexpected loss. Ш 


У Pi-hole is a network- 
wide ad blocker 
that's effective and 
easy to use 
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How to write your own 
©, emulator in Python 


Download 


the code 
f GitHub: , 
wimag.ce/ Ever wanted to create your own computer? Heres how to do 


wfmag54 


just that - and even get it to run some classic games 


AUTHOR 
EDWIN JONES 


A software engineer at video game developer Mediatonic, Edwin Jones 
has been working in the games industry for around 16 years. Find out 
more about him here: edwinjones.me.uk 


ow can we make our own computer simple specification to implement. The CHIP-8 
LN with Python? Don't computers need only has 35 opcodes, which is low compared 
ГЕ lots of physical things like circuit to other computers. You still have allthe usual 
boards and electronics? Normally problems to solve - loading binary files, parsing 
yes, they do, but we’re going to opcodes, and then running them on virtual 
create something known as a virtual machine’ - а hardware - but not the other baggage that comes 
computer defined completely by software, not with trying to write emulators for other systems. 
hardware. You've probably used virtual machines You also get to finish the project by playing some 
many times without realising it. Many modern classic games - what's not to like? 
games consoles run older, classic games via We'll be using Python 3 and Pygame for the 
virtual machines, also known as emulators. project because CHIP-8 isn't very demanding 
There are many kinds of emulator, but one and can be easily emulated. This means it's a 
of the most fun to start with is the CHIP-8. The good fit for Python, as we don't need to worry 
CHIP-8 was never a real computer, but that's so much about performance and can use a 
what makes it fascinating: long before most other language that makes solving the problems at 
games systems, it existed as a program for 8-bit hand a bit easier - we don't need to focus as 
computers in the 1970s. This means there's no much on smaller details. 
hardware to attempt to emulate and quite a A simple way to build such a device in code 


is with a class representing the CPU, so let's go 

ahead and create a Cpu class. Create a folder 
Name called pychip8 on your machine and save our 
code below there with the file name cpu.py. We'll 


^ roms 
р; в be using this folder for every module we create. 
[а _main_ 
[à cpu = т н 
ч il "this module defines the chip 8 cpu" 
@ font 


\@ keyboard input EN 


€. operation code """this class represents the CHIP 8 cpu""" 


(a operation mapping 


* operations # game ram begins at address 0x200 / 512 


@ renderer PROGRAM START. ADDRESS = 0x200 
> All being well, your pychip8 à load А ; ; 
folder should look like this @ rom loader # the chip 8 works with 16 bit/2 byte opcodes 
when you're finished. WORD. SIZE. IN BYTES = 2 
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# V[15/0xF] is used as а carry/no borrow flag 
for certain ops 

ARITHMETIC_FLAG_REGISTER_ADDRESS = @хЕ 

FRAME_BUFFER_WIDTH = 64 

FRAME_BUFFER_HEIGHT = 32 


def __init__(self): 
# 4k of RAM 
self.ram = [0] * 4096 
self.program_counter = self .PROGRAM_START_ 
ADDRESS 


self.index_register = 0 
self.general_purpose_registers = [0] * 16 


self.delay_timer = 0 


self.stack = [] 
self.stack pointer = 0 


self.keys = set() 


self.frame buffer = [[bool()] * 32 for i 
in range(64)] 


Self. load font() 


self. current word = 0 
self. current operation - None 


Can you see how we've defined the registers 
and buffers from the system's specification into 
simple Python types and collections? Don't worry 
about understanding all this code right now, as 
we'll be plugging in more parts of the computer 
as we go. This is just the ‘heart’ of the machine 
and where our core logic will run. 

The CHIP-8, like almost all computers, works 
by following a sequence 
of instructions. We're 
going to load up files 
representing these 
instructions in a binary 
format (called ROMs) and 
process each instruction one by one in our CPU. 
The name for such an instruction is sometimes 
known as - you guessed it - an opcode! 

The problem we face now is how can we get 
he data from a file into memory so our code can 
work with it? We can do this with a simple 'ROM 
oader' module that reads all the binary into a list 


"There are many emulators, 
but one of the most fun 
to start with is CHIP-8" 


for us to use later. You can see how this works in 
the code below - save this into your folder with 
the file name rom loader.py. 


import os 


def get rom bytes(rom name): 
"""This method loads the bytes from a rom from 
the roms folder""" 
folder = os.path.dirname(os.path.realpath(. . 
file )) 
rom folder = os.path.join(folder, "roms") 
rom file path = os.path. join(rom folder, 
rom name) 


with open(rom file path, "rb") as file: 
file bytes - file.read() 
return file bytes 


Here we're opening and reading the file in binary 
mode with the "rb" options string from the given 
file path and returning it from the get. rom bytes 
method as a bytes object. This means we can 
then iterate over each byte in turn to decode 
each instruction for the CHIP-8. 

How can we parse the raw binary from a file 
and turn that into instructions for the CPU? The 
CHIP-8 has a strange 
opcode definition, in 
that each opcode is a 
16 bit / 2 byte value that 
contains the instruction 
and the data for that 
instruction. This would be simple enough were it 
not for the fact that apart from the first four bits, 
each following nibble can be part of an instruction 
or data - depending on the instruction in 
question. For instance, the opcode Ox00EO means 
‘clear the screen’, but opcode 0x1234 means 
‘jump to memory address 0x234'. A nibble might 
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A There are all kinds of simple 
games available for CHIP-8, 
from puzzlers to dinky 
Space Invaders clones. You'll 
find a good selection at 
wfmag.cc/chip-roms. 


( h en 
2 Ж 


i 
PEED 48 
s ОЕМОК moonglow bay ^ R 


Wireframe 


This tutorial first appeared 
in Wireframe, our sister 
magazine that lifts the 

lid on the world of video 
games. Every issue includes 
tutorials and in-depth 
interviews, along with news 
and reviews of the latest 
indie and triple-A games. 


To find out more, visit their 
website at wfmag.cc. 


Check out their 
subscription offers at 
wfmag.cc/subscribe. 


mS. — A 
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This module defines methods that define the different operations the CHIP-8 
CPU could perform. 


import random 


import font 


# V[15] is used as a саггу/по borrow flag for certain ops 
CARRY FLAG ADDRESS = ХЕ 


def add to x(opcode, cpu): 
cpu.general purpose registers[opcode.x] += opcode.nn 
cpu.general purpose registers[opcode.x] &= OxFF # restrict the value to one 


byte or less 


def add x to i(opcode, cpu): 
cpu.clear arithmetic flag() 
original value - cpu.index register 
result = cpu.index register + cpu.general purpose registers[opcode.x] 
result &- OxFFFF # restrict the value to two bytes or less 


^ Be sure to get the 
full CHIP-8 code from 


wfmag.cc/wfmag54, TA , 
where voullifind the sound strange, but it's just half a byte. A byte is 
operations.py module, 8 bits and can be represented with two hex digits, 
and more detailed А 

comments that vie So OxFF means 255. A nibble can be represented 
couldn't fit in here. with one hex digit (e.g. OxF for 15). This will come 


in handy later when we're manipulating our 
opcode data. One way 


self.word - word & OxFFFF 


# we just want the most significant bits/ 
nibble 

# here so we bitshift right 

self.a = (word & QxFQQQ) >> 12 


self.nnn = word & OxO0FFF 
self.nn - word & 0x00FF 
self.n - word & 0x000F 


# Where don't use the lower nibbles, 
bitshift 

# right to get just the raw value 

self.x = (word & 0x0F00) >> 8 


# Eg. we want 0x4 not 0x40 
self.y = (word & 0x00F0) >> 4 


Don't worry if you don't understand all this 
code at once. The important thing to know is 
that we're parsing a 16-bit value and storing it 
in different fields of the class. opcode.a is the 
leftmost nibble, x the 


to solve this problem is “Don't worry if you next one along, y the 


to abstract it into a class, 
which is exactly what 


don’t understand all 


one after that, andn 
the very last. You can 


we're going to do. this code at once” remember this with the 


Our next piece of 
Python code is going to be an Opcode class, as 
shown below. Again, save this into your folder, 
this time with the file name operation_code.py. 


class Opcode: 
"""This class represents the instructions and 


data of an opcode 


def __init__(self, word): 
This class takes in a 2 byte value/word 
and parses the bytes 
to store them in different attributes for 
later use 


Args: 


word: a 2 byte/16 bit value that 
represents an opcode. 


# We use bitwise AND with a mask to 
extract specific nibbles. 


# a word should be no more than 16 bits 
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hex-like pattern OxAXYN. 
opcode.word, opcode.nn, and opcode.nnn are ways 
of accessing these nibbles in groups. This will 
come in handy later on. 

Now we have a way to read the ROM and parse 
the contents of it, but what can we actually do 
with all this data? The CHIP-8 has 35 opcodes, 
but we shall only be using 33 of them. For 
simplicity, we're ignoring sound and any machine 
code operations. You can find a list of them on 
Wikipedia at wfmag.cc/opcode. 

First, let'S define a module that turns 
these opcodes into readable functions we 
can reference. Hex is fun, but it's not easy to 
understand what the raw numbers mean at 
times. The following bit of code is too long to 
run in full here, but you'll find it on our GitHub 
at wfmag.cc/wfmag54. It's the file named 
operations.py - here's a small snippet: 


def add to x(opcode, cpu): 
pass 


def add x to i(opcode, cpu): 
pass 
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Command Prompt 
def add_y_to_x(opcode, cpu): 
pass 


Don't worry that all these functions contain a pass 
statement at the moment; the important thing is 
that each one has the same signature and a clear 
name. Now we need to make another module, 
called operation mapping.py, that lets us map 


the raw binary/opcode to one of the functions 
we've defined above. Modelling code without 

a full implementation like this is often known 

as stubbing, and can be a useful approach to 
working on a problem when you aren' entirely 
sure what the solution will be, but do need to 
have some idea of the interface you'll be using to 


solve it. 


from operation code import Opcode 


import operations 


def find operation(word): 
opcode - Opcode(word) 


if word == 0x00E0: 


return operations. 


if word == Ox00EE: 


return operations. 


if opcode.a == 0х1: 


return operations. 


if opcode.a -- 0x2: 


return operations. 


if opcode.a == 0x3: 


return operations. 


if opcode.a -- 0x4: 


return operations. 


if opcode.a == 0x5: 


return operations. 


if opcode.a == 0x6: 


return operations. 


if opcode.a -- 0x7: 


return operations. 


if opcode.a -- 0x8: 


clear. display 


return from function 


goto 


call function 


skip if equal 


skip if not equal 


Skip. if x y equal 


set x 


add to x 


if opcode.n -- 0x0: 


return operations.set x to y 
if opcode.n == 0x1: 

return operations.bitwise or 
if opcode.n == 0x2: 

return operations.bitwise and 
if opcode.n == 0x3: 

return operations.bitwise xor 
if opcode.n == 0x4: 

return operations.add y. to x 
if opcode.n == 0x5: 

return operations.take y. from x 
if opcode.n == 0x6: 

return operations.shift x right 
if opcode.n == 0x7: 

return operations.take x from y 
if opcode.n == OxE: 

return operations.shift x left 


if opcode.a -- 0x9: 
return operations.skip. if x y not equal 


if opcode.a == 0xA: 
return operations.set i 


if opcode.a == 0xB: 
return operations.goto, plus 


if opcode.a == @хС: 
return operations.generate random 


if opcode.a == 0xD: 
return operations.draw_sprite 


if opcode.a == @хЕ: 
if opcode.nn == @х9Е: 
return operations.skip_if_key_pressed 
if opcode.nn == ӨхА1: 
return operations.skip. if key not pressed 


if opcode.a -- OxF: 


^ Once it's complete, you can 
run CHIP-8 straight from 
your command line, like this. 


TECH SPECS 


The CHIP-8 has the following 

specifications: 

® AkB of memory 

* 16 general-purpose 8-bit 
registers (the 16th is 
also used as a special 
arithmetic flag at times) 

* A 64 pixel-wide by 32 pixel- 
high frame buffer 

* A stack that stores return 
addresses for function 
calls and nothing else 


e Some way to store 
the pressed state of a 
16-button keypad (0-Р) 


e An 8-bit index register 

e An 8-bit program counter 

e An 8-bit stack pointer 

e An 8-bit delay timer register 


e An 8-bit sound timer 
register (when above zero, 
a beep is made) 
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v Yes, it’s a bit blocky, but 
it’s a tiny, functioning 
version of Space Invaders. 
Pretty neat. 


address 


to_x 


to_x 


if opcode.nn == 0x07: 


return operations. 


if opcode.nn == @х@А: 


return operations. 


if opcode.nn == 0x15: 


return operations. 


if opcode.nn == 0x18: 


return operations. 


if opcode.nn == Ox1E: 


return operations. 


if opcode.nn == 0x29: 


return operations. 


if opcode.nn == 0x33: 


return operations. 


if opcode.nn == 0x55: 


return operations. 


if opcode.nn == 0x65: 


return operations. 


set_x_to_delay_timer 


wait_for_key_press 


set_delay_timer 


set_sound_timer 


add_x_to_i 


load_character_ 


save_x_as_bcd 


save_registers_zero_ 


load_registers_zero_ 


raise KeyError(f"Opcode {word:#06x} not 


present in list of valid operations") 


Now we're cooking! This code will take a block of 


16 bits we load from a RO 


file, parse this into 


our custom Opcode class and use the properties 


of that class to figure out w 
functionality the opcode is 


hat corresponding 
eferencing. If you 


refer to the table from wfmag.cc/opcode, you 
should be able to see exactly what our functions 


are going to actually do by 
related opcode. 
Before we can wire this u 


ooking up the 


p further, we're going 


to need to add some extra functionality. There 
are a few opcodes that handle drawing to the 
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screen, loading fonts, and input handling, so we 
need to define code that can manage this logic 
for us. Let's start with the internal font of the 
machine. The CHIP-8 has a single font that is 
hard-coded into memory, and usually stored in 
the first 512 bytes of memory (0x000-0x200). The 
font is basically a pattern of bits that describes 
the dots that make up each letter. Let's make a 
module with this pattern as shown below, and 
save it as font.py. 


Chars are 4x5. Each line must be a byte wide so 
each line value is padded with 0x0. 


Eg: 
0: 
HHH = 1111 = FO 
# # = 1001 = 90 
# # = 1001 = 90 
# # = 1001 = 90 
HHH = 1111 = FO 


won 


# each char is 5 bytes long, so to get 

# char 'B' you'd use DATA[LCHAR_SIZE_IN_BYTES х 
0xB] 

CHAR_SIZE_IN_BYTES = 5 


DATA = [OxF0O, 0x90, 0х90, 0x90, OxFO, #0 
0x20, 0x60, 0x20, 0x20, 0x70, #1 
OxF0, 0x10, OxFO, 0x80, OxFO, #2 
OxF0, 0x10, OxFO, 0x10, OxFO, # 3 
0x90, 0x90, OxFO, 0x10, 0x10, # 4 
OxF0, 0x80, OxFO, 0x10, OxFO, # 5 
OxF0, 0x80, OxFO, 0x90, OxFO, # 6 
OxF0O, 0x10, 0x20, 0x40, 0x40, #7 
OxF0, 0x90, OxFO, 0x90, OxFO, # 8 
OxF0O, 0x90, OxFO, 0x10, OxFO, # 9 
OxF0, 0x90, OxFO, 0x90, Ox90, # A 
OxEO, 0x90, OxEO, 0x90, OxEO, # B 
OxF0, 0x80, 0x80, 0x80, OxFO, # С 
OxEO, 0x90, 0x90, 0x90, OxEO, # р 
OxF0, 0x80, OxFO, 0x80, OxFO, # Е 
QxFO, 0x80, OxFO, 0x80, 0x80] # Е 


The code above is a layout of a series of nibbles 
in a list format that we can access, and each 

5 bytes represents the raw pixels of a character. 
Each "1" equals a lit pixel for each character; each 
character is 4 bits across and consists of 5 rows. 
As we only use a nibble, only the most significant 
bits of each byte are used - that is why each 
value ends with 0. 


Next, we're going to need some way to handle 
input. The CHIP-8 had a very simple input 
mechanism - 16 keys from 0-Е. This fits exactly 
into a nibble. Let's define a module to map our 
keyboard keys to those values. Save the following 
as keyboard input.py: 


"""This module contains the keyboard input 


won 


handling logic 


import sys 
import pygame 


keys = {} 

keys[pygame.K 0] = 0x0 
keys[pygame.K 1] = 0x1 
keys[pygame.K 2] = 0x2 
keys[pygame.K 3] = 0x3 
keys[pygame.K 4] = 0x4 
keys[pygame.K 5] - 0x5 
keys[pygame.K 6] = 0x6 
keys[pygame.K 7] = 0х7 
keys[pygame.K 8] = 0x8 
keys[pygame.K 9] - 0x9 
keys[pygame.K a] = 0xA 
keys[pygame.K b] = 0xB 
keys[pygame.K c] = 0xC 
keys[pygame.K d] = 0xD 
keys[pygame.K e] = OxE 
keys[pygame.K f] = OxF 


def handle input(cpu-None): 
This function handles control input for this 
program. 


won 


for event in pygame.event.get(): 


# quit if user presses exit or closes the 
window 
if event.type == pygame.QUIT: 
sys.exit() 


# check cpu registers and inject key input 
if cpu: 
if event.type == pygame.KEYDOWN: 
if event.key == pygame.K_ESCAPE: 
sys.exit() 


if event.key in keys: 
cpu. key_down(keys[event.key]) 


if event.type == pygame.KEYUP: 
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A CHIP-8 Noughts and 
Crosses. Perfect if you 
don't have a pen and 
piece of paper handy. 


if event.key in keys: 
cpu. key. up(keysELevent. key 1) 


This code defines a dictionary to map keyboard 
input into and a function we can use to check 
which keys are pressed. We then pass that dat 
into our CPU. Handy! 

The last missing part of our emulator is the 
enderer. A renderer is simply some code that 
can take raw data and instructions and turn 
hose into some form of visible output. We'll use 
Pygame Zero to draw to our screen and we can 
define our renderer like so, remembering that 
he CHIP-8 was limited to a 64x32 resolution with 
black and white output. The following needs to be 
saved with the file name renderer.py: 


iad) 


"""This module defines the renderer object and 


"пп 


related methods 


import pygame 


WHITE = pygame.Color(255, 255, 255) 
BLACK = pygame.Color(0, 0, 0) 
SCALE - 10 


# The CHIP-8 display ran at only 64 * 32 pixels. 
# this value scales the framebuffer 

# so it's easier to view the emulator on modern 
displays 

Screen = pygame.display.set  mode((640, 320)) 


def render(frame buffer): 
"""This method draws everything to the screen 


Screen. fill(BLACK) 


for x in range(64): 
for y in range(32): 
if frame buffer[x]Ly]: 
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^ Figure 1: If the bc test.ch8 
ROM shows this message, 
then congratulations: you 
have a functioning CHIP-8 
emulator, and you're ready 
to play some games! 


pygame.draw.rect( 
screen, 
WHITE, 
(x * SCALE, y * SCALE, SCALE, 
SCALE)) 


# Go ahead and update the screen with what 
we've drawn. 

# This MUST happen after all the other drawing 
commands. 

pygame . display.update() 


The code above takes the frame buffer of the CPU 
and iterates through it, drawing a 10x10 white 


square for every pixel that should be set. This gives 


us a larger window to see the emulator running, 
and will be easier to use on a larger, modern 
display. A frame buffer is just a section of memory 
that stores things you want to show on a display 
monitor or TV. In our case, it's just a 2D list of 
Boolean values representing 'on' or 'off for a pixel 
that we defined in our Cpu class earlier. 

We're getting closer to having something 

work as all the core components of our system 
are now wired in. There's a bit more code we 
need to add to our CPU now we've defined all its 
dependencies. Let's go back and add some extra 
imports to the top of our CPU module, cpu.py: 


from operation code import Opcode 
import operation mapping 
import font 


Now append the code below to the end of the 
CPU module: 


def key. down(self, key): 
"This method sets a key as pressed" 
if key not in self.keys: 
self .keys.add(key) 


def key. up(self, key): 
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"This method sets a key as released" 
if key in self.keys: 
self .keys.remove(key) 


def move_to_next_instruction(self): 
self.program counter += Cpu.WORD_SIZE_IN 


BYTES 


def move_to_previous_instruction(self): 
self.program counter -= Cpu.WORD_SIZE_IN 


BYTES 


def load_rom(self, rom_bytes): 
for i, byte_value in enumerate(rom_bytes): 
self. ram[Cpu.PROGRAM_START_ADDRESS + 
1] = byte_value 


def set_arithmetic_flag(self): 
self.general purpose registers[self. 
ARITHMETIC FLAG REGISTER ADDRESS] - 1 


def clear arithmetic, flag(self): 
self.general purpose registers[self. 
ARITHMETIC FLAG REGISTER ADDRESS] = 0 


def emulate cycle(self): 
self. current word - self.fetch word() 


opcode = Opcode(self.. current word) 
self. current operation - operation. 
mapping.find operation(self.. current word) 


self.move to next instruction() 
self. current operation(opcode, self) 


def fetch word(self): 
word = self.ram[self.program counter] << 8 
| self.ram[self.program counter + 1] 


return word 


def update timers(self): 
if self.delay timer > 0: 
self.delay timer -- 1 


def . load font(self): 
offset - 0x0 
for item in font.DATA: 
self.ram[offset] - item 
offset += 1 


If you read through the code above, you should 
be able to understand what each method is doing 


as there is a comment in each one to help you 
understand the code. We'll need this for the next 
step as we're going to revisit our operation Class 
and fill in the blanks we left earlier. This is going 
to be quite a lot of code - as before, it's too much 
to print here, so download the file operations.py 
from our GitHub at wfmag.cc/wfmag54. Dont 
worry too much about what each method does; 
focus more on what opcode it relates to and what 
functionality it achieves for our emulator. There 
are several comments to help you understand 
each opcode, if you're interested. 

We only need to write one more module to get 
our emulator working and to see our hard work 
pay off. We need an entry point to our code that 
initialises and runs it in the right order. Let's go 
ahead and create a file called. main. .py (NB: 
there are two underscores either side of the 
word ‘main’ that will handle all this for us. 


"""This is the main entry point for the program 


import argparse 
import keyboard input 
import renderer 
import rom loader 
import pygame 


from cpu import Cpu 
if name == "__таіп__": 


parser = argparse.ArgumentParser() 


" 


parser.add argument("-r", "--rom", 
required-True, type-str, help-"the name of the rom 
to run in the emulator") 


args - parser.parse args() 


cpu 7 Cpu() 

clock = pygame.time.Clock() 

rom bytes = rom loader.get rom bytes(args.rom) 
cpu. load rom(rom bytes) 


pygame.display.set caption("pychip8") 
pygame. init() 


# main loop 
while True: 
keyboard input.handle input(cpu) 


# The CHIP-8 is reported to run best at 
around 500 hz 
# The update loop runs at 60 fps. 60* 8 = 


480, which is close enough. 


for _ in range(8): 


cpu.emulate cycle() 


cpu.update timers() 
renderer . render (cpu. frame buffer) 


# delay until next frame. 
clock.tick(60) 


The code above sets up all the dependencies, 
oads the ROM data, and runs the core loop of 
the CHIP-8 CPU, which will read and evaluate 
instruction by instruction. Don't worry about 
"running out”, as almost every ROM loops; they're 
not designed to terminate without user input. 

The last thing we'll need is a ROM to test this 
out with. First, le's use a debug ROM - the best 
've found is called bc test created by BestCoder. 
Create a folder called roms in your working 
directory and copy bc test.ch8 into it from this 
repository: wfmag.cc/chiptest. 

With the ROM in place, open the directory that 
contains your pychip8 folder in your terminal 
of choice and run the command python pychip8 
--rom="be_test.ch8". You should see something 
like the output in Figure 1. If you do, have a round 
of applause - you have a working emulator! If you 
see nothing on the screen, the error's likely in 
the renderer module; if you see a screen like the 
one in Figure 2, then you'll be able to work out 
what's gone wrong by checking the error codes at 
wfmag.cc/error-codes. 

Once you're sure the test passes, it's time for 
real games! There are plenty of ROMs available 
for the CHIP-8 - you'll find several at wfmag.cc/ 
chip-roms. Just copy the files into your roms 
folder and run the command, replacing the test 
ROM name with the name of the ROM you want 
to run, and bingo: you're playing games on a 
computer that you wrote yourself! 
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€ Figure 2: If running the 
bc test.ch8 ROM gets you a 
message like this, then you 
can troubleshoot your 
emulator with the error list 
at wfmag.cc/error-codes. 
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Raspberry Р! 


_ Operating 


Systems 


Whatever you want to do with Raspberry Pi, there's an 
operating system for that, as Phil King finds out 


official Raspberry Pi OS is an excellent, 
easy-to-use operating system, but it's not the 
only show in town. 

You might want to give an alternative general- 
purpose OS a go, such as the popular Ubuntu with its 
slick interface and large software catalogue, or the 
user-friendly and accessible Manjaro. If you're feeling 
adventurous, there's also RISC OS: an evolution of the 
Acorn Archimedes operating system dating back to 
1987, it's super-fast and offers a fascinating insight 
into how desktop OSes used to look and work. 


B ased on Debian, a flavour of Linux, the 


Other Raspberry Pi operating systems are aimed 
at particular use cases. For media playback, there's 
LibreELEC and OSMC: both based on Kodi, they 
offer a slick interface for navigating your music and 
video collections, as well as streaming media. Retro 
gaming fans are also well catered for with a choice 
of RetroPie, Recalbox, and Lakka for emulating old 
consoles and computers. Then there are specialist 
OSes such as OctoPi (3D printing) and Home 
Assistant (smart home). 

Trying out a new operating system is as easy as 
writing it to a microSD card with the Raspberry Pi 
Imager tool (magpi.cc/imager), which has many OS 
options already built-in, so why not give it a go? 
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Ubuntu Desktop 


Type: General-purpose 


Available: Raspberry Pi Imager, ubuntu.com/raspberry-pi 


Works on: Raspberry Pi 4 (4GB+), 400, CM4 (4GB*) 


Minimum card size: 16GB 


cost-effective PC alternative for years, 

but you don't have to stick to the official 
Raspberry Pi OS: Ubuntu is a popular flavour of 
Linux used on millions of PCs around the world. 

While Ubuntu is also available in more 
lightweight Server and Core versions, the new 
Desktop edition is the fully-fledged version of the 
Linux distro. So if you've used it before, it'll all be 
very familiar in how it looks and works. 

Available in the menu of the Raspberry Pi 
Imager tool (magpi.cc/imager), it's a pretty large 
download and takes a little while to write to a 16GB 
or larger microSD card. Boot it up on Raspberry Pi 
and it starts with a system configuration welcome 
wizard where you can set up the keyboard type, 
WiFi connection, and add a new user. It then takes 
a few minutes to configure everything. 

The GNOME desktop environment is 
aesthetically pleasing with an applications sidebar, 
launcher, and search facility. The downside is that 
it's rather sluggish to use: there's a slight delay 
whenever you open or do anything on the desktop. 
Not everything works out of the box, either: you 
may well get a message saying you need to install 
some extra packages to do something such as 
playing MP4 videos. 


р eople have been using Raspberry Pi as а 


One of the main advantages of Ubuntu is its 
huge software library. Pre-installed apps include 
the Firefox web browser, Thunderbird email client, 
Rhythmbox music player, and LibreOffice suite. 
More can be installed via the Ubuntu Software tool 
- or, a little confusingly, also from the Snap Store, 
Synaptic Package Manger, or Terminal. You may 
well find more recent versions of some software 
than in Raspberry Pi OS, such as 
Python 3.8. The GPIO pins can 
be used by installing the LGPIO 
Python library. 

If you want to stay on the 
cutting edge, Ubuntu gets a major 
update twice a year, although 
this can sometimes cause issues 
with stability. 


Fully-fledged desktop OS 
Slick, modern GUIL 

Large software catalogue 

Can be a bit sluggish and flaky 
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“It'll 

even run 
on the 
original 
Model B” 
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RISC OS Pi 


Type: General-purpose 
Available: Raspberry Pi Imager 
Works on: All models 


Minimum card size: 2GB 


ow this one takes us back. RISC OS was first 
developed by Acorn to run on its 32-bit 
ARM-based Archimedes home computer 
in 1987. Since Raspberry Pi also uses an ARM CPU, 
it seems only fitting that the OS is available for it. 
A community of enthusiasts continues to develop 
RISC OS, including a special version tailored for 
Raspberry Pi 400 (available from riscosopen.org). 

The first thing you'll notice when installing 
RISC OS is how compact it is. This is an ultra- 
lightweight OS that only requires a 2GB microSD 
card - there's no advantage in using a larger one, 
since the OS can only use the first 2GB. Amazingly, 
it'll also work on any Raspberry Pi model, even the 
original Model B from 2012. 

The old-school GUI is a world away from 
Raspberry Pi OS or Ubuntu. It looks very retro and 
applications are grouped together in folders rather 
than in a main menu. The other aspect you'll notice 
is that it runs like lightning, even though it only 
operates on a single core of the CPU. 

An intriguing aspect is that it's based around 
using a three-button mouse: the left button is select, 
middle (or scroll wheel) displays a contextual menu, 
while right is ‘adjust’ (a modified version of select). 


Raspberry Pi operating systems 


Once you get the hang of it, this can prove very 
effective. If you only have a two-button mouse, you 
can always assign a keyboard key as the third button. 

Bundled software includes the primitive NetSurf 
web browser, PipeDream office suite, and a selection 
of basic games (called ‘diversions’). Using the 
StrongEd text editor, it's possible to program in 
languages such as BBC BASIC, Lua, and Python. 
Extra software can be installed using the !Store and 
PackMan package managers. 

The biggest downside is that Raspberry Pi's 
on-board wireless LAN is not yet supported, so 
you'll need to use a wired Ethernet connection or a 
special WiFi HAT to get online. In addition, the GPIO 
pins on more recent Raspberry Pi 4 models aren't 
recognised, while the USB 3.0 ports only work at USB 
2.0 speeds. 

Still, it's well worth a look for the nostalgic and 
the curious and could prove useful for learning how 
computers work under the bonnet. 


Ultra-lightweight OS 
Extremely fast to use 

Looks very old-fashioned 

No support for on-board WLAN 


Type: General-purpose 
Available: Raspberry Pi Imager, manjaro.org 
Works on: Raspberry Pi 3, 4, 400, CM3/3+/4 


Minimum card size: 8GB 


anjaro aims to be a simpler, more 
M user-friendly version of Arch Linux while 
providing all the benefits of cutting-edge 
software - it boasts its own large repository 
alongside the Arch User Repository. 

You can install Manjaro with one of four 
desktops - KDE Plasma, GNOME, Xfce, MATE - or 
the lightweight Sway window tiling manager, ora 
minimal version with no desktop. 


Based on Arch Linux 
Highly customisable 
Good choice of desktops 
Large software repository 


LibreELEC 


Type: Media centre 
Available: Raspberry Pi Imager, libreelec.tv 
Works on: Allmodels 


Minimum card size: 16GB 


ased around the 
B Kodi media player 
software, LibreELEC 
is a lightweight single- 
purpose distro that’s 
simple to set up and use. The menu system is 
slick and easy to navigate, with sections including 
movies, TV shows, and music. You can also stream 
media by installing add-ons for services such 
as YouTube, BBC iPlayer, and Disney+. With a 
Raspberry TV HAT attached, you can even use it as a 
personal video recorder. 


Slick, easy-to-use interface 

Supports most media files 

Highly customisable with add-on 
Watch and record live TV (with TV HAT) 


Kali Linux 


? Type: Security testing 
? Available: kali.org 
> Works on: All models 


> Minimum card size: 16GB 


penetration testing. Once installed on Raspberry Pi, you can use 
it to audit the security of other devices on your network. 
There's no configuration wizard, so you'll need to set up a few 
things manually. You do get a desktop (Xfce), though, and a set of 
built-in security apps, plus the Firefox web browser. 


K: is a specialist distro for information security tasks such as 


* Specialist security distro 

* Good range of OS versions 

* Set of built-in testing tools 

* Some manual configuration needed 
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OSMC 


_ Type: Media centre 


RetroPie 


_ Type: Retro gaming 


- Available: Raspberry Pi Imager, osmc.tv 


_ Available: Raspberry Pi Imager, retropie.org.uk 


_ Works on: АЦ models 


. Works on: All models 


. Minimum card size: 16GB 


- Minimum card size: 8GB 


is a fully-fledged OS, enabling you to install 

other applications. So it may prove more 
versatile if you need to also use your Raspberry Pi 
for anything else, such as a web server. 

When using it for Kodi media playback, OSMC 
works very similarly to LibreELEC with an easy- 
to-use menu system to navigate media categories 
such as movies, TV, and music. 


B ased around the Kodi media player, OSMC 


_ Fully-fledged operating system 
_ Versions for different models 

_ Kodi media playback 

_ Versatile and customisable 


Raspberry Pi OS versions 


With Desktop (32-bit): 
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brings together a suite of emulators for 
over 50 retro consoles and computers. 
Running it on a Raspberry Pi 4 or 400 gives you 
the most power, enabling better emulation 
of later systems such as the PlayStation 2, 
GameCube, and even the Wii. 
Use it in a standard setup with a monitor or, for 
a more authentic experience, a bartop or full-size 
arcade system. 


B uilt on top of Raspberry Pi OS, RetroPie 


_ Emulates over 50 systems 

- Works on all models 

_ Customisable menus and settings 
_ Large community to offer advice 
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Lakka 


Type: Retro gaming 
Available: lakka.tv 
Works on: All models 


Minimum card size: 8GB 


gaming. Each game is implemented as 

a libretro 'core', while RetroArch takes 
care of the inputs and display. So, while it 
doesn't support quite so many systems as its 
rivals, it offers a single, unified, and consistent 
configuration for all its emulators. Controllers 
typically work as soon as you plug them in, too. 


| akka is another solid option for retro 


MotionEye0S 


Type: Security camera 


Available: magpi.cc/motioneyeos 
Versions for all models 


Download from website Works on: АЦ models 
Painless configuration 
Samba sharing for ROMs 


Minimum card size: 1GB 


video surveillance system using a Camera 

Module and/or USB camera. You can even 
set up a network to cover different rooms of your 
home, monitoring all the camera feeds in a web 
interface. It can be set to capture photos and video 
whenever motion is detected on a camera, and 
send you email/push alerts. 


T: OS turns your Raspberry Pi into a 


CCTV security system 
Options for multiple cameras 
Can monitor several rooms 
Download from website 


Recalbox 


R ecalbox offers a wide range wide of 


> Type: Retro gaming 


emulators for retro gaming - if not > Available: Raspberry Pi Imager, recalbox.com 


quite so many as RetroPie. It does > Works on: All models | 


come with the Kodi media player built-in, 
though, so it’s ideal if you’re look for an all- > Minimum card size: 8GB 
in-one entertainment system. 
Recalbox also adds a share partition on * Versions for every model 
the microSD card so you can easily remove * Wide range of emulators 
it from Raspberry Pi to add game ROMs on * Kodi media player built-in 
another computer. * Share partition for ROMs 
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info-beamer 


Type: Digital signage 
Available: Raspberry Pi Imager, info-beamer.com 
Works on: Raspberry Pi 2, 3, 4, Zero W, CM3/3*/4 


Minimum card size: 8GB 


found in shops, restaurants, cinemas, 

museums, etc. To create your own, all 
you need is a Raspberry Pi with info-streamer 
installed and a monitor or TV. 

Sign up for a free account and you can monitor 
and control your device(s) from a web dashboard. 
With multiple screens and Raspberry Pi boards, 
you can even set up a video wall. 


D igital signage installations are typically 


Digital signage solution 
Cloud dashboard 

Monitor multiple devices 
Build your own video wall 


OctoP! 


> Type: 3D printing 
> Available: Raspberry Pi Imager, octoprint.org 
> Works on: Raspberry Pi 3, 4, 400, CM3/3*/4 


> Minimum card size: 8GB 


WiFi to any 3D printer with 
a USB port, for easy file dropping 
and remote control via a web 
dashboard. You can also adda 
camera to the setup for a live video 
stream of the 3D printing process, 
and to record time-lapse videos. 


* Control a 3D printer 

* Access via web interface 
* Live camera stream 

* CuraEngine slicing 
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Wayne's Widgets 


0 ctoPi contains the OctoPrint software for monitoring 


Normal opening h« 


urs, Jan 


controlling a 3D printer remotely from a web browser. It adds 


Home 
Assistant 


Type: Smart home 


Available: Raspberry Pi Imager, home-assistant.io 
Works on: Raspberry Pi 3, 4, 400 


Minimum card size: 4GB 


ome Assistant is an open-source 
H ecosystem for smart home automation and 

boasts a helpful worldwide community of 
enthusiasts. Easy to set up and use, it features 
‘Integrations’ (plug-in modules) to support over 
1,000 smart devices; you can even program your 
own in Python. Little wonder PJ Evans opted to 
use it for his tutorial series on home automation 
starting in The MagPi issue 99 (magpi.cc/99). 


Over 1,000 devices supported 
Sophisticated web dashboard 
Powerful automations 

Google or Alexa voice control 
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Homebridge 


Type: Smart home 


“Your Homebridge setup 
can be controlled via a 
web-based interface” 


Available: Raspberry Pi Imager, homebridge.io 
Works on: Allmodels 


Minimum card size: 4GB 


pple’s HomekKit is great for controlling 

your smart home, but it’s not compatible 

with all devices. Homebridge offers a 
Raspberry Pi-based solution, enabling you to 
integrate other devices such as Nest thermostats, 
Ring video doorbells, Philips Hue light-bulbs, and 
Sonos speakers. 60°C 

Your Homebridge setup can be controlled = 

via a web-based interface, including 
installing or removing plug-ins - there are 
over 2,000 available. м 


меток 


3.81 GB 


3.5 GB 


12m 


Use other devices with Homekit 
Over 2,000 plug-ins 
Web-based interface 

Voice control with Siri 


Other OSes 


We didn't have space in this feature to cover every available operating system for Raspberry Pi. 
Here are a few others to consider.. 


Alpine Linux (alpinelinux.org): Lightweight OS 
with an emphasis on security. 


ALT (altlinux.org): Russian language OS, 
available in Raspberry Pi Imager under 'Other 
language-specific OS: 


Arch Linux ARM (archlinuxarm.org): Lightweight 
and flexible OS, the basis of Manjaro. 


CentOS (centos.org): Robust Linux distro, 
popular for running web servers. 


Chromium OS (magpi.cc/chromiumos): The 
open-source basis for Chrome OS, as used in 
Chromebooks. 


DietPi (dietpi.com): Extremely lightweight 
Debian-based OS with a simple interface. 


emteria.OS (emteria.com): Full build of 
Android, aimed towards industry use. 


Fedora ARM (arm.fedoraproject.org): ARM 
version of Fedora Linux, only works on 


Raspberry Pi 2 and 3. 


FreeBSD (freebsd.org): UNIX-like operating 
System, an alternative to Linux. 


FydeOS (fydeos.io): Customised version of 
Chromium OS for Raspberry Pi 4 and 400. 


Gentoo (gentoo.org): Highly customisable 
Linux distro, not easy to install. 


Lubuntu (lubuntu.net): Lightweight Linux OS 


based on Debian, with minimal LXDE desktop. 


NetBSD (netbsd.org): Fast and secure UNIX- 
like OS based on BSD. 


piCorePlayer (picoreplayer.org): Minimal OS 
designed for remote music playback. 


Pi MusicBox (pimusicbox.com): Stream music 
or play locally stored tracks and podcasts. 


Slackware ARM (sarpi.penthux.net): 
Slackware is one of the oldest Linux distros. 


SliTaz (slitaz.org): Compact OS that works 
completely in memory from an attached 
USB stick. 


TLXOS (thinlinx.com): A ‘thin client’, available 
as a 30-day trial in Raspberry Pi Imager. it's a 
compact OS that's useful for kiosk displays. 


Void Linux (voidlinux.org): Independent 
general-purpose Linux distro. 
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Hiwonder TonyPı 


DIMENSIONS: 
186 x 113 x 
373mm; 17kg 


COMPONENTS: 
Raspberry Pi 4 
4GB, 11V battery, 
3MP camera 
(480x800 pixel) 
14 x LX-824HV 
servos, on-board 
lithium-ion 
battery pack with 
DC charging point 
(US adapter), 
power level 
indicator 


ACCESSORIES: 
3x Tag cards, 3 x 
colour balls, servo 
wire, screwdriver 


» With 14 servos, TonyPi 


is both powerful and 
responsive to 
user commands 


> Hiwonder » hiwonderhk № £380/$519 


Raspberry Pi 4-powered humanoid robot with built-in smarts 
and options to set up bespoke behaviours. By Rosie Hattersley 


with plenty of personality to keep you 
engaged as you learn fun ways to interact 
with him. He can either be controlled via an iOS 
or Android app, or you can use a Raspberry Pi, 
Windows PC, or Mac. 
Containing a Raspberry Pi 4, TonyPi comes 
preassembled (aside from the connectable head), 


T onyPi is a 37 cm-tall humanoid robot 
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so the fun here is all about controlling him. He's 
a solidly built fella, with angular joints and broad 
lower arms and hands primed for scooping up 
coloured balls on command. We rather liked his 
all-white finish, which contrasts with his 14 
deliberately visible LX-824HV servos. Agility- 
wise, TonyPi can walk, shimmy, wave, bow, get 
up, and turn his head - all from the smartphone 
or tablet app, while more advanced controls 

can be added as custom list items via Python 
and OpenCV. 


2 We tried to fool him with 
posters of people and 
various charming but 
inanimate objects, but 
TonyPi was unmoved Ø 


Swiping a finger in the window section of the 
Hiwonder app moves TonyPi's head. You'll need 
to swipe several times to get TonyPi to move 
much, though. Body movements can be initiated 
using the step controls at the top of the on- 
screen control panel, or by tapping within the 
circular control area. The upper control section 
causes TonyPi to step forwards and backwards 
and turn gently to one side, while the circular 
control section sees him jump peremptorily 
whichever way he's instructed. 


Clear vision 

TonyPi’s object recognition ability is great. One 
neat trick is his ability to recognise faces, waving 
in response. We tried to fool him with posters 

of people and various charming but inanimate 
objects, but TonyPi was unmoved. 

‘Colour tracking’ was also impressive: select 
acolour and move the corresponding ball gently 
in front of his 3-megapixel camera and TonyPi’s 
head will follow the ball’s movements. He will 
also nod when shown an object that’s red, green, 
or blue - our orangey-red sofa was an easy win - 
but he doesn’t always get it right. 

Line following was largely successful: TonyPi 
strode along confidently on straight stretches, 
slowing but still following the line round gentle 
bends. It’s best to set his head to point down so 
he is able to follow the trail; if not, he may veer 
off unexpectedly at an angle. Three QR codes are 
included in the box: place these against a light 
background and TonyPi will wave, shimmy, or 
shuffle his feet. You can also create your own QR 


codes and have your robot do something else, 
having programmed a different action in Python 
using the instructions provided. 

Be aware that switching user modes causes 
TonyPi to revert to his initial position, as we 
inadvertently discovered. If TonyPi is lying 
down, you're likely to have one heck of a shock 
when you switch him back on and tap the 'get 
up’ instruction on the Hiwonder app. TonyPi 
launched himself backwards as he automatically 
tried to stand upright from the prone position 
we'd left him in. Luckily, your reviewer caught 
him just as he was about to disappear off the 
edge of the kitchen table. 

Instructional PDFs really help in getting 
the most from using TonyPi, but using a PC or 
Raspberry Pi as a control via SSH and a smartphone 
hotspot is extremely fiddly, more than pi-top's 
Robotic Kit with its built-in IP address-displaying 
OLED [magpi.cc/108]. Once set up, though, 
possibilities such as adding a microphone and 
trying voice recognition come into play. El 
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9 TonyPiis a great- 
looking robot that can 
be easily controlled via 
Android or iOS apps 


Verdict 


TonyPi is an 
impressively 
designed robot 
with solid object 
recognition 
features. For 
longer-term 
entertainment, be 
prepared to log in 
remotely and 

use Python to 
access his more 
advanced features. 


8. 
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Мад! 


10 Amazing: 


This project tests your fidget-spinning skills to see just how fast you can get out 
of the maze determined by how fast you spin. 


A look back at some of Mike Cook's 
best builds in The MagPi 


ou may have read last month that Mike 

Cook, legendary tech writer and author of 

our monthly Pi Bakery since issue 33, has 
decided to retire from regular tutorials in The MagPi. 
While we'll see him again in the future, we wanted 
to highlight ten very cool things that he made over 
nearly 80 issues. Thank you, Mike! 


Use a tablet to control this wonderful, 
old-school storytelling method that 
will be sure to impress and entertain 
many kids, young and old. 


Perfect for the spooky season, these 
Scary skeletons can be made to 
deviously dance by your own hands, 
while classical music is played 

of course. 


This guitar uses a mixture of Raspberry Pi Pico and Trill touch sensors to create 
a very customisable MIDI guitar. We love the case for it as well. 


A fun holiday game to make and play, where you take the reins of 
Santa's sleigh to deliver The MagPi magazines to kids everywhere. 
Unfortunately, the real Santa is too expensive to use monthly. 


82 magpi.cc Mike Cook projects 


Mägpi 


Wooden train sets are irresistible. You have to play with them. 


Linking them up to an e-book allows you to turn pages using the 
train, a great way to keep kids engaged with reading. 


Meet Head and Ron, glowing spooky creatures that are used as part of the 
Collider game, where you try and match the lights at the right moment. 
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Use various knobs and dials to change your voice using this 
Raspberry Pi Pico project in a very cool box. 


Using some rotary encoders, you can interact with an oscilloscope to create 
weird and wonderful noises, for fun and scary movies. 


This cool little instrument is one of 
many that Mike has made, with sides 


you can tap for sound. This two-part 
tutorial starts in issue 90. 


Mike is also the author of Raspberry Pi Projects for 


Dummies, which you can grab at magpi.cc/mikecook. 
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Е ОЕ O cm 
with Raspberry P1 


Discover how to design your own electronic 


circuits with these resources. By Phil King 


Forrest M Mims 


Getting Started 
in Electronics 


Price: 

£24.99 / $20 
magpi.cc/ 
electronicsmims 


Online courses 


Who better to teach you the 
fundamentals of electronic 
circuits than Forrest M Mims, 
the designer of the original 
Altair 8800 home computer? 
Billed as a complete electronics 
course in 128 pages, this classic 
tome is all the more remarkable 
for its handwritten text and 
hand-drawn diagrams! While 
there are more in-depth 
electronics books around, this 
one will certainly give you a 
solid grounding. 


Starting with the basics of 
electricity, it takes you on a 
tour of digital and analogue 
components and how they work. 
It moves on to integrated circuits 
and digital logic gates using 
switches and transformers. 
Linear circuits are also 
covered; responding to a wide 
range of voltages, they have 
many applications. 

Of most interest to us is the 
section on using electronic 
components to make temporary 


Study circuit design with these 
interactive courses 
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CRASH COURSE 
ELECTRONICS & PCB DESIGN 
This Udemy course is aimed 

at those learning electronics 
from the ground up who wish to 
leverage that knowledge to build 
actual PCBs. 

> magpi.cc/crashcoursepcb 


TINKERING FUNDAMENTALS: 
CIRCUITS 

Participation is essential in 
Coursera's hands-on workshop 


(i.e. on a breadboard) and 
permanent circuits. There are 
100 tried and tested circuit 
designs to explore, arranged 
into categories such as basic, 
photonic, digital, and linear. El 


as students are encouraged to 

try things out, ask questions, 

and share ideas with each other as 
a community. 

> magpi.cc/tinkeringcircuits 


ADVANCED DIPLOMA IN 
BASIC ELECTRONICS 

This free Alison course covers the 
principles of electronics and some 
of the theorems guiding the design 
of electrical circuits. 

> magpi.cc/alisonelectronics 


An Introduction 
to Electronics 


This OpenLearn course is 


Open University 
an adapted extract from the 


Price: Open University course T212 
Free Electronics: sensing, logic and 
magpi.cc/ actuation. Just sign up for a free 


openlearnelectronics ^ account to enrol. Taking around 


Free course Free statement 
An introduction to electronics [E] s 


on completion 


HackSpace 
Magazine £48 


The ultimate achievement 


Ben Everard DRE inam 
1n circuit design 1$ to create 


Price: your own printed circuit board 
(PCB), but it may seem a 
daunting prospect. The latest 
issue of our sibling magazine, 
HackSpace, demystifies the 
process with a 12-page feature 
showing you how to get started. 
As the article explains, “If 
you can build electronics on 
a breadboard, you can design 
a PCB. There's no magical 
difference. Instead of wires, you 
just have traces of copper." 
Using the EasyEDA online 
software (easyeda.com/editor), 


£6 / $8 (or free PDF) 


hsmag.cc/issue48 


ten hours at your own pace, it 
starts with the basic theory of 
electrical circuits, including 
Ohm’s law, Kirschoff's laws, and 
series and parallel circuits. 

It then goes on to cover some 
fundamental circuits - including 
voltage dividers, the Wheatstone 
bridge, operational amplifiers, 
and sensors - before exploring 
the concept of signal processing 
using sounds. 

Each section features videos 
and/or interactive elements, By 
the end of the course, you should 
be able to use basic components 
to design simple electronic 
circuits, as well as having learnt 
alot more about the general 
concepts involved. Ш 


MAKE BUILD HACK CREAT 


— 


| Leam 
Sewind e 


um tubes 


| масо 


it takes you through all the steps 
of designing a PCB to work with 
a Raspberry Pi Pico. Starting 
with a schematic, various 
components are added, along 
with custom artwork and copper 
traces for connections. Finally, 
you can send your board design 
off to be manufactured. El 
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RESOURCES | Magri EEE 


Check out these 
info-packed books 


маф 


ELECTRONICS 


Sei ZERO 


Q \ = Baspberry Pi 


SIMPLE ELECTRONICS 
WITH GPIO ZERO 

Build breadboard-based 
electronic circuits connected 
to Raspberry Pi and control 
them with Python programs 
and the easy-to-use GPIO 
Zero library. 

> magpi.cc/gpioessentials 


MAKE: ELECTRONICS 

A great primer for general 
electronics, it's full of 
interesting facts and runs 
you through 36 ‘experiments’ 
building circuits using 
standard components. 

> magpi.cc/ 
makeelectronics 


ELECTRONIC CIRCUIT 
DESIGN IDEAS 

Aimed at the more advanced 
user, this weighty compendium 
covers over 170 circuit types 
and explains them in great 
detail with diagrams. 

> magpi.cc/ 
circuitdesignideas 


WE Magri | INTERVIEW 


W This optical drive 
would take care 
of Akkie's hamster 
while he was away 
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Can you be a maker without knowing electronics? 
Akkie was before Raspberry Pi 


» Name Akira Ouchi | 
» Community role Maker | 
44 

| at all before I learned 

and started playing with 
Raspberry Pi.” 

Not the kind of thing you'd 
expect to hear from one of the 
best-known members of Japan's 
wonderful maker community, 
Akira Ouchi, or Akkie as he's 


best known. He had been doing 
little projects though, like 


had no electronic skills 


» Occupation Infrastructure engineer 
» Website github.com/Akkiesoft 


sticking a pen into an old mouse 
to create a sort of tablet, or 
making use of an optical disc 
drive to look after his hamster. 
“Although the term “ТоТ? 
was not common in 2009, I 
combined the optical drive, 
cardboard, and springs to create 
a thing that could feed the 
hamster or control the power 
switch of the air conditioner 


by [moving] the tray of the 
optical drive," Akkie tells 

us. “It is quieter, easier, and 
smarter to implement similar 
functions with a Raspberry Pi, 
server monitor, and infrared 
LED nowadays." 


When did you learn about 
Raspberry Pi? 

I discovered Raspberry Pi on 

the RS Components’ website 

on 12 March 2012 - I found this 
from my Twitter [Ed, see photo]. 
At that time I used a Linux 
netbook for my optical drive IoT 
project to demonstrate at some 
events. I thought Raspberry 

Pi could make it compact the 
demo stuff. After replacing the 
netbook with Raspberry Pi, I 
created a wearable optical drive 
attached on the top of a helmet, 
and Raspberry Pi built-in 
optical drive. 


What are your favourite 
things that you’ve made with 
Raspberry Pi? 

My fave is a Plarail (Japanese 
train toy for kids) project 

that can be controlled from a 
smartphone. A Raspberry Pi 
Zero and camera are mounted 
to the carriage, [along with 


m | think it's amazing the sense of unity 
a community can feel when they get 
their hands on a junk part 8 


a] built-in motor driver and 
LiPo battery. 

I enjoyed using the motor 
driver to control acceleration 
and deceleration, and the design 
of the web UI. 


What differences have you 
noticed in the Japanese maker 
community compared to 

the USA/UK? 


Furthermore, Japan has its 
own certification system for 
power supplies and radio waves, 
and it often takes a long time 
for foreign products to become 
available in Japan. Sometimes 
they cannot be used in Japan 
because the manufacturer often 
does not obtain certification 
in Japan. Compared to the 
certification system in US or 


а 640х48 pixel LCD that was 


INTERVIEW | MägPi En 


А Akkie's first 


Raspberry Pi, as 
posted to his Twitter 
account in 2012 


I don't know much about built into a children's toy and 


overseas maker communities (or 


UK, L assume it makes things 


apanese communities even), 
but when I saw maker events in 
US or the UK, I found there were 
more huge (literally!) projects 
than in Japan. It might be hard 
for us to create huge projects in 
apan because, in many cases, 
there is not enough space in our 
house to work in. 


Ь This train set is controlled by 
Raspberry Pi Zero and a smart 
phone. There's a Camera Module 
stuck to the front as well 


ess flexible for Japanese 
makers’ projects which use 
radio waves... 

Apart from our country's 
system, I think it's amazing the 
sense of unity a community can 
feel when they get their hands 
on a junk part. In early 2021, it 
was very popular for Japanese 
makers on Twitter to take out 


analyse it. No matter if they 
knew each other or not, makers 
brought information they had to 
Twitter and GitHub, and made 
controlling the LCD possible 

in a few weeks. That was really 
amazing. It is available for 
Raspberry Pi as well. I followed 
those instructions, bought the 
toy, and made it work too. Ш 


See Akkie's work 


"[Over the last yearl, there has 
been no online event for Open 
Source Conference ( OSC: 
оѕрп.јр). | usually exhibit and 
introduce Raspberry Pi projects, 
and give a presentation as 
Japanese Raspberry Pi Users 
Group at the OSC's events. I 
also showed projects at Japan's 
Maker Faire events. 

“| post about projects and 
Ithe] making process on my 
blog (magpi.cc/akkieblog) and 
Mastodon (magpi.cc/akkie)." 


Translation 
by Satoka Fujita 
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MagP1 
Monday 


Amazing projects direct from our Twitter! 


Surrogate 01 
@SurrogateTV 


Replying to @TheMagPi 


very Monday we ask the question: have you A Raspberry Pi doggie cam to check on the dog and 
made something with a Raspberry Pi over give her snacks at a press of a button. om 
the weekend? Every Monday, our followers 


send us amazing photos and videos of the things 
they’ve made. 

Here’s a selection of some of the awesome things 
we got sent this month - and remember to follow 
along at the hashtag ttMagPiMonday!! 7 


01. Pet-cam number one this month, with a 
cute dog to keep track of 


02. Ausefulrange sensor! And a clever way to 
Solve a voltage problem 


03. Chickens count as pets, right? A great use of > @Frank76139220 
a simple automated Raspberry Pi project 


04. Pet-cam the third, with a small cat napping Replying to @TheMagrt 


BISSERL Managed to combine the ultrasonic distance sensor 
05. Litter collection of the future maybe? with the LCD through my Pico. Had to use a voltage 
06. This would not look out of place on the divider as my HC-SRO4 is neither + nor P. 


robot that Sly is cutting from Rocky IV 


07. Thisisa very cool upcycling project. Be 
careful working with a big computer 
PSU, though! 


08. Robot mower updates are always fun - this 
one keeps getting better 


09. A great start to Halloween decorations from 
early October 


10. Thisis a very impressive synth idea brought 
to life! 


Tl. Using some clever code, CycOb has 
managed to create virtual bumpers so that 
this robot knows when it has hit an obstacle 
by how much power the motor is using 
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Марі 


A Cédric de l'Epine Naranjü 
I Pspiderland, @yuudi 


Replying to @TheMagPi Replying to @TheMagPi 

My chicks doorman :) Python + MQTT + TweePy : Pet cam. Send commads 
IR cam and gate control (open / close the coop via cron| | via MQTT,takes picture or animate gif. Post it in a 
and web) privarse tweeter account. 


TheAmplituhedron 


&ThAmplituhedron 
Raplying ta i meMagP: 


Based on (^ Raspberry Pi 4, | designed this 
autonomous (lidar) litter detection robot employing an 
@Edgelmpulse object detection model to recognize 
and classify litter. It also deploys a video stream and a 
fall detection system. 


£ WI AT ТА Stewart Watkiss 


(Bstewartwatkiss 
Replying to @Th=MagP! 


Raspberry Pi pixel-server to control RGB LEDs / 
NeoPixels using a web browser. 


@ EI. 


Reptying to STNeMagPi 


Also works with smartphone and home automation. 


| made а matrix flash LEDs randomly with a @pimoroni youtu.be/s5Evig_VRdE 
Plasma RP2040 LED controller board for my #PiWars 
a ыы - - : It will be used for lighting up my driveway at Halloween, 
but remember: a Raspbery Pi is for life, not just for 


Halloween € 


Replying to &TheMogP 


No Halloween edition, but the upcoming Model П 

the PiMowBot will have a tilt compensated compass 
based on a 9-axis IMU MPU-9250-module and a more 
powerful motor driver. | just finished the software 
tweaks for this over the weekend. 


youtube.com 

Raspberry Pi Wireless NeoPixel server for RGB LEDs 
Run a wireless NeoPixel / Pixelstrip server on a Raspberry Pi 
па Python, Flask and WS281x library turns a Raspberry 


#RaspberryPi #Robotics #Lawnmower 


== 
| 
| 


юруге to O Thea 


Got my CD-ROM plotter working! Thanks to 
(&homofaciens! Still needs some tweaking... 


GoPiGo3 Stalled Wheels.mov 


Replying to @TheMagPi >= ГЕТ 
Nothing for Halloween, but this is looking like it is = Eisen; 
to have it's scary moments... >з оз өз © P d 


diyelectromusic.wordpress.com/2021/10/08/bar... 


#MagPiMonday 


diyetectromusic.wordpress.com 


“Bare Metal" Raspberry Pi Synth 
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Best of 
the rest! _ m © 


mn in mu te 


Amazing projects that we were ош == . - = 
contacted about this month : 


PIHUNTER == 


ЕНА ————— а 


> magpi.cc/pihunter 
We got an email from Gabriel Simches, a cyber 
security analyst, about his Raspberry Pi threat- 


hunting device, which he has excellently called 
piHunter. He reckons it will work at home andin Неге are the tools it runs: 
a *small to mid-sized office” as well. 

“Set up a Raspberry Pi to collect full- packet 
captures on your network, then index, normalise, 


and search through your data to find anomalies," В | 

Gabriel writes on GitHub. “АП the data and tools Filebeat Winlogbeats (TBD) | RITA Run-RITA-Run | tcpdump 
activity is ready to go! A good threat-hunting nak ped a ua pun 
device has both GUI tools and multiple Living off 
the Land (LotL) tools." 


INTERACTIVE BOOKSHELF 


> magpi.cc/iotlibrary 


“The Internet of Things landscape is riddled 
with commercial companies that want to gather 
as much data as they can, while I think a library 
thrives on privacy," writes Willem Jan in his blog 
about his interactive bookshelf idea. Using a series 
of sensors and LEDs, Willem thinks he can make 
finding and discovering books more fun. 

The blog goes into his research on sensors, 
microcontrollers, and microcomputers, before 
giving a practical build for your bookshelf. 

* Although this blog is very technical, I will try to 
inform a general audience about the possibilities 
that the Internet of Things has to offer." 


90 | magpicc | Bestofthe rest 


THIS MONTH IN RASPBERRY РІ | Мас INNEN 


TERMINATOR HUD 


> magpi.cc/termhud 


Ever wanted to see like the Terminator? Maybe not 
but it's a cool idea for a video filter that looks great 
as well. It's all written in Python for Raspberry Pi 
Camera Modules, and works best on Raspberry Pi 4 
as it needs a bit of oomph to get it working. 


TRACKING PLANES IN BRAZIL 


> magpi.cc/coffeeradiopod 


We got an email from Martin Butera who hosts a podcast 
in Brazil's capital, Brasilia, about radio and coffee. While 
talking to Thiago Pereira Machado, he mentioned how he 
used Raspberry Pi to track aircraft, a cool and common 
project for English speakers but not one we've seen in 
Portuguese before. 


Crowdfund this! zoe Р 7 


\ = 


Little Hackers 


Mini Pupper 


A cute quadrapedal robot based on Raspberrry Pi, it's 
perfect for learning about robotics with it's incredible 12 Learning to code with less screen time was something 
degrees-of-freedom and open source software including Google Engineer Brandon Tory was worried about, so he 
the Robot Operating System, OpenCV for computer created a book to allow you to do just that with help from 
vision, and SLAM for mapping its surroundings. his six-year-old son 

» kck.st/3zVVaZA > kck.st/3zOfvQr 
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44 Raspberry Pi Zero 2 
is here, and we 
gave one to all 
current subscribers. 
Get yours with a 
new subscription 


Subscriber gifts 


I was wondering if you were still doing a Raspberry Pi Zero with your 
subscriptions? Do subscribers get anything else as well with their 
subscription? I’ve been meaning to get one for ages. 


Christof via Twitter 


As you may have noticed by now, the subscription offer has been 
upgraded to include a Raspberry Pi Zero 2. You can find more info 
about that on page 32. As for gifts, current subscribers also received a 
Zero 2 in the post. Subscribing is the best way to make sure you get 
any of the special items we give away! 
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A lot of people love to share what 
they're working on via Twitter 


If Ihave a Raspberry Pi project 
Га like you to see, where is the 
best place to send it? 

Ithink it would be a great fit 
for The MagPi. 


Daisy via email 


We're more than happy to look at 
any Raspberry Pi, Raspberry Pi 
Pico, or RP2040 projects that you 
may have done, and emailing is 
the best way to show us. 
Otherwise, contacting us on 
Facebook, or showing us on 
#MagPiMonday on Twitter is a 
good start! Sometimes, if we see 
it online, we'll also contact you 
about it. Whether it becomes a 
project showcase, a mention in 
This Month in Raspberry Pi, ora 
retweet, we love to see and share 
what you're making! 


Марі 


Маке sure to check 


out our spooky project 


upgrades feature in 


issue 110 for some last- 


Will you be showing off Halloween projects again this year from the minute ideas 
community? I've got some really fun plans and I was wondering 


whether I should send them to you! I hope you like being scared... 
Phil via Facebook 


We absolutely will if you share it with us! Due to the peculiarities of 
creating a magazine, this November issue will come out a few days 
before Halloween, and the issue after Halloween has happened will be 
the December issue - which will have Christmas stuff in it. Don't 
worry, though: we'll print them any time of the year. 

Speaking of which, don't forget to send us your Christmas projects 
too! Although they’ll probably end up in the February issue. 


Twitter 
Facebook 
Email 
Online 


Your Letters magpi.cc 
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E-INKDISPLAY PHATS 


WITH 20 HEATSINKS FOR RUNNERS-UP! 


IN ASSOCIATION 
WITH THE PI HUT 


This 2.13" E-Ink display is perfect 
for the Raspberry Pi Zero 2 W 
that you can get free with your 
twelve-month subscription to 
The MagPi. We have five to give 
away, and 20 runner-up prizes 
of a heatsink for Zero 2 as well. 


Head here to enter: magpi.cc/win | Learn more: magpi.cc/einkdisplayphat 


Terms & Conditions 


Competition opens on 27 October 2021 and closes on 26 November 2021. Prize is offered to participants worldwide aged 13 or over, except employees of the Raspberry Pi Foundation, 
the prize supplier, their families, or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the competition, the winner consents to any 
publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine. We don't like spam: participants' details 
will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. Winners will be contacted by email to arrange 
delivery. Any winners who have not responded 60 days after the initial email is sent will have their prize revoked. This promotion is in no way sponsored, endorsed or administered by, 
or associated with, Instagram or Facebook. 
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QuickStart guide to setting up The very best projects built by 
your Raspberry Pi computer your Raspberry Pi community 


Updated with Raspberry Pi Pico Discover incredible kit and 
and all the latest kit tutorials for your projects 


| 


\ we * E s 
mme ЗР werd 


» 
RASPBERRY AI OS TIPS | 


м 1 ts \ 
«t incredible projec” iw 1 
sta РЕ 


EDITORIAL 
Editor 

Lucy Hattersley 
lucy@raspberrypi.com 


Features Editor 
Rob Zwetsloot 
rob@raspberrypi.com 


Sub Editor 
Nicola King 


ADVERTISING 

Charlotte Milligan 
charlotte.milligan@raspberrypi.com 
+44 (0)7725 368887 


DESIGN 


criticalmedia.co.uk 


Head of Design 
Lee Allen 


Designers 
Lucy Cowan, Sam Ribbits 


Illustrator 
Sam Alder 


CONTRIBUTORS 

David Crookes, PJ Evans, Satoka 
Fujita, Rosemary Hattersley. 
Edwin Jones, Nicola King. 

Phil King, KG Orphanides 


PUBLISHING 
Publishing Director 
Russell Barnes 
russellaraspberrypi.com 


Director of Communications 
Liz Upton 


CEO 
Eben Upton 


DISTRIBUTION 
Seymour Distribution Ltd 
2 East Poultry Ave, 
London EC1A ӨРТ 

*44 (0)207 429 4000 


SUBSCRIPTIONS 

Unit 6 The Enterprise Centre 
Kelvin Lane, Manor Royal. 
Crawley, West Sussex, RH10 9PE 
+44 (01293 312193 
magpi.cc/subscribe 
magpi@subscriptionhelpline.co.uk 


This magazine is printed on paper sourced 
from sustainable forests and the printer 
operates an environmental management 
system which has been assessed as 
conforming to ISO 14001. 


The MagPi magazine is published by 
Raspberry Pi (Trading) Ltd., Maurice Wilkes 
Building, St. John's Innovation Park, Cowley 
Road, Cambridge, CB4 ODS. The publisher, 
editor, and contributors accept no 
responsibility in respect of any omissions 
or errors relating to goods, products, or 
services referred to or advertised in the 
magazine. Except where otherwise noted, 
content in this magazine is licensed under 
a Creative Commons Attribution- 
& NonCommercial-ShareAlike 
3.0 Unported 
(CC BY-NC-SA 3.0). 


Raspberry Pi 
PRESS] ISSN: 2051-9982. 


ПЕНИ Mägi | THE FINAL WORD 


Tapping into tech 


Intriguing early encounters with computing led to 


Rosie Hattersley's career wri 


of computers when my visiting 

aunt reached into her bag and 
triumphantly produced lengths of stiff 
cardboard with seemingly random 
bits punched out. Whereas my mum 
had been one of the earliest female 
students of cybernetics, her sister 
had gone into teaching maths. Both 
were perfectly placed to encounter 
programming 1970s-style, and my 
mum spent two happy years as a 
Fortran programmer. 

School meant Casio watches and 
LED displays; sometimes built into 
pleasingly flexible, twangable rulers; 
sometimes embedded into the shaft of 
a pen. Resetting the time and date was 
the ideal excuse to linger ina 
classroom while chatting to (aka 
flirting with) nerdy, but nice, 
schoolmates. Almost without fail, an 
overlooked friend would interject with 
a rude word spelled out on their fancy 
scientific calculator screen. 

The arrival of two BBC Micros in the 
school library caused a stir. Asa 
wannabe journalist, I became the 
editor of the newspaper we put 
together as a class. Getting to use one 
at school meant taking business and 


| first encountered the concept 
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information studies so I could get at 
the Acorn computers in the commerce 
suite. Unfortunately, I had to spend 
the first half-term learning to touch- 
type - anathema for an impatient and 
less than dextrous teenager. 


Commodore coding 
Thankfully, a brilliant Commodore 64 
made it into our home. I spent hours 
learning to play a musical keyboard 


M The arrival of two 
BBC Micros in the 
school library 
caused a stir Л 


which sat above the computer’s own 
keyboard, and typing in game code 
from books. I taught myself BASIC and 
set up modest databases to organise 
my growing record collection, but was 
often ousted from the C64 by my 
games-hungry brother, keen to thrash 
another joystick in the service of Daley 
Thompson’s Decathlon. 

Our Dad spent an apocryphal £3000 
on a Elonex 386 laptop, heavier even 


ting about them 


than the Smith Corona typewriter 
with the three-page text memory that 
I would write my university essays on. 

My first computer was a second- 
hand Mac, so I could brush up the 
QuarkXpress and Photoshop skills I 
used in my first job in publishing, 
indirectly taking me to a writing role 
at home computing title PC Advisor 
where I got to try out, review, and 
write about using hundreds of 
gadgets, games, apps and programs 
and, eventually, learn about an 
intriguing product known as 
Raspberry Pi and its aim to put 
computers and computing skills in the 
reach of the world. The global success 
of maker faires, Raspberry Jams, Pi 
Wars, Code Clubs and dojos, as well as 
the dozens of individual projects that 
Руе been lucky enough to learn about 
first hand and write about for The 
MagPi, show that Raspberry Pi has 
brilliantly delivered. Ш 


Rosie Hattersley 


Rosie Hattersley has been writing about 
the joy of tech for the past two decades 
and (occasionally) still misses QuarkXpress. 


@RosieHattersley 
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PROFESSIONAL CONTROL SYSTEM DEVELOPMENT TOOL 


Home projects made easy. 


CDP Studio, a great software development tool for your home projects. Build 
systems for Raspberry Pi, use C++ or NoCode programming, open source libraries, 
out of the box support for GPIO, 12C, MQTT, OPC UA and more. Create beautiful user 
interfaces. Built for industrial control system development, FREE for home projects. 


cdpstudio.com 
Tel: +47 990 80 900 • info@cdptech.com : 
CDP Technologies AS // Hundsvzergata 8, 6008 Ålesund, Norway CDPStudio 


HiPi.io 


GHPI PRO 


.— The new case from the HiPi.io team — 


“ЩТ, 
} c “ШЕТ 


€ Rapid tool-free assembly and disassembly € Secure microSD card cover 

€ Large internal volume for HATs € VESA mount support 

e Compatible with Pi 2/3/4 e Molding-configurable output ports 
e Multiple lid options customizable for volume orders 

€ Passive & Active Cooling options e Printed logo for your branding 


Available at these great Pi stores: 


“2 MI 4 I d nhs 
&-PiShop.us {rfPiShop.ca {*fPiShop.mx — GJsPiHut PrSior.ch Welectron. 


Contact your favorite Pi store if it’s not listed here 


